Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

An Account API key, account-scoped JWT, App API key, or user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************.

Headers

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
Example:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-09-06"

Body

application/json
platform
enum<string>
required

The platform to connect the social account on. Use meta_business to connect Meta Business assets, which is how Facebook Pages and Instagram accounts are connected — there is no separate instagram value. Use tiktok for TikTok accounts.

Available options:
meta_business,
tiktok
Example:

"meta_business"

redirect_url
string
required

Where to send the user once they finish connecting their accounts. Any http or https URL. If the connection fails, the user is redirected with a social_account_error query param.

Example:

"https://example.com/settings/social-accounts"

account_id
string

The Account (biz_ identifier) to connect the social account for. An account-scoped API key may omit this to default to its own account.

Example:

"biz_xxxxxxxxxxxxxx"

scopes
enum<string>[]

Capabilities to grant for the connected social account. advertise is required for both meta_business and tiktok connections — it is not conditional on whether you intend to run ads, and omitting it fails the request.

Available options:
advertise

Response

authorize url returned

authorize_url
string
required

The OAuth authorization URL to redirect the user to.

Example:

"https://www.facebook.com/v25.0/dialog/oauth"