Skip to main content
POST
Start one channel's OAuth

Authorizations

Authorization
string
header
required

Your API key, sent as Authorization: Bearer <key>. One key manages every profile on the account.

Body

application/json
platform
enum<string>
required

One channel key. Only the OAuth channels can be started from a picker; the app-password channels are linked with POST /v1/connections/{channel} instead.

Available options:
tiktok,
instagram,
linkedin,
youtube,
facebook,
x,
threads,
pinterest,
reddit,
bluesky,
google_business
profile_id
string

Id of the brand profile to act on. List them with GET /v1/profiles.

friendly_name
string

Display name for a profile created on the fly by this call.

Response

Success.

The response envelope is stable — a profile_id plus the payload — but its inner fields are not yet pinned down in this document.