Skip to main content
POST
Finish a connect flow

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.