Connect a Social Account
Starts an OAuth connection flow for a social account and returns an authorize_url to redirect the user to. Today the only supported platform is meta_business, which grants the advertise scope so the connected Facebook page and Instagram account can run ads. The required permission follows the requested capability: the advertise scope requires ad_campaign:create (so advertiser roles can connect), other scopes require social_account:create. The connection is authorized against the account given by account_id (a biz_ identifier); an account-scoped API key may omit it to default to its own account.
Authorizations
An account API key, account scoped JWT, app API key, or user OAuth token.
Headers
Pins the request to a dated API version.
"2026-07-08-1"
Body
The Whop URL to redirect the user to after they finish connecting.
The platform to connect the social account on.
meta_business The Account (biz_ identifier) to connect the social account for. An account-scoped API key may omit this to default to its own account.
Capabilities to grant for the connected social account, for example advertise.
advertise Response
authorize url returned
The OAuth authorization URL to redirect the user to.

