Connect a Social Account
Starts an OAuth connection flow and returns an authorize_url where the user can connect a social account.
Authorizations
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
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-09-06"
Body
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.
meta_business, tiktok "meta_business"
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.
"https://example.com/settings/social-accounts"
The Account (biz_ identifier) to connect the social account for. An account-scoped API key may omit this to default to its own account.
"biz_xxxxxxxxxxxxxx"
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.
advertise Response
authorize url returned
The OAuth authorization URL to redirect the user to.
"https://www.facebook.com/v25.0/dialog/oauth"

