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-08-13"

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
Example:

"meta_business"

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"

redirect_url
string

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

Example:

"https://whop.com/core/api/callback/meta/"

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.

Example:

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