Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key
string

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Maximum string length: 255

Body

application/json
platform
enum<string>
required
Available options:
facebook,
instagram,
linkedin,
tiktok,
twitter,
pinterest,
googleads
account_id
string

Parent posting channel (sacct_…), for same-token platforms.

ad_account_id
string

Scope sync to one Meta ad account (act_…).

redirect_url
string
force
boolean

Re-run OAuth even though a connection already exists. Without it a same-token connection (facebook/instagram/linkedin/pinterest) keeps answering already_connected on its posting token, so a channel whose token lacks ads scopes can never be repaired.

Response

Connection result (already_connected, account, or auth_url).

The response is of type object.