Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

A company API key, company scoped JWT, app API key, or user OAuth token. You must prepend your key/token with the word 'Bearer', which will look like Bearer ***************************

Headers

Api-Version-Date
string

Pins the request to a dated API version.

Example:

"2026-07-18"

Body

application/json
platform
enum<string>
required

The platform to connect the social account on. Supported options are meta_business and tiktok.

Available options:
meta_business,
tiktok
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.

redirect_url
string

The Whop URL to redirect the user to after they finish connecting.

scopes
enum<string>[]

Capabilities to grant for the connected social account. Use advertise when connecting a Meta Business or TikTok account for ads.

Available options:
advertise

Response

authorize url returned

authorize_url
string
required

The OAuth authorization URL to redirect the user to.