Skip to main content
POST
/
v1
/
accounts
/
connect
/
{platform}
/
complete
Finish a connect flow
curl --request POST \
  --url https://api.letmepost.dev/v1/accounts/connect/{platform}/complete \
  --header 'Content-Type: application/json' \
  --data '
{
  "profileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "profileId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "platformAccountId": "<string>",
  "displayName": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "tokenExpiresAt": "2023-11-07T05:31:56Z",
  "pinterest": {
    "defaultBoardId": "<string>",
    "defaultBoardName": "<string>"
  },
  "instagram": {
    "kind": "<string>",
    "accountType": "<string>",
    "grantedScopes": [
      "<string>"
    ]
  }
}

Path Parameters

​
platform
enum<string>
required

Supported platforms. tiktok is currently in App Review — connect requests return platform_not_enabled until approval lands.

Available options:
bluesky,
facebook,
instagram,
linkedin,
pinterest,
threads,
tiktok,
twitter

Body

application/json

Provider-specific completion payload — see the platform's connect doc.

​
profileId
string<uuid>

Response

Account re-connected (token rotated on an existing row).

A connected platform account. Secrets never leak — only display name, platform identifiers, and lifecycle timestamps. Platform-specific extension blocks (e.g. pinterest, instagram) carry non-sensitive metadata.

​
id
string<uuid>
required
​
profileId
string<uuid>
required
​
platform
enum<string>
required

Supported platforms. tiktok is currently in App Review — connect requests return platform_not_enabled until approval lands.

Available options:
bluesky,
facebook,
instagram,
linkedin,
pinterest,
threads,
tiktok,
twitter
​
platformAccountId
string
required

The platform's own user/account id (e.g. Twitter user id, IG Business id).

​
displayName
string | null
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
tokenExpiresAt
string<date-time> | null
​
pinterest
object

Pinterest-only metadata block.

​
instagram
object

Instagram-only metadata block. accountType and grantedScopes echo what Meta reports.