Skip to main content
POST
TypeScript

Authorizations

Authorization
string
header
required

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

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-25"

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, snapchat for Snapchat Public Profiles, or linkedin to connect the authenticated user’s LinkedIn profile.

Available options:
meta_business,
tiktok,
linkedin,
snapchat
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. Omit for user profile connections.

Example:

"biz_xxxxxxxxxxxxxx"

scopes
enum<string>[]

The connection purpose. For meta_business and snapchat, advertise is required and connects company advertising assets. For linkedin, omit scopes to connect the authenticated user’s profile; advertising is not supported. For tiktok, omit scopes to connect the authenticated user’s profile, or pass advertise to connect company advertising assets. Profile connections still request the platform permissions needed to read the profile.

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"