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-07-29-1"

Body

application/json
platform
enum<string>
required

The platform to create the social account on.

Available options:
facebook
account_id
string

The Account (biz_ identifier) to create the social account for. An account-scoped API key may omit this to default to its own account.

Response

social account created

error
string | null
required

Why this social account currently can't be used for advertising — a failed share or a Meta-side restriction. Null when the account is healthy.

external_id
string | null
required

The platform-specific ID for this social account.

id
string
required

Unique identifier for the social account.

name
string | null
required

The display name of the social account on the platform.

platform
enum<string>
required

The platform the social account exists on.

Available options:
x,
instagram,
youtube,
tiktok,
facebook,
discord,
telegram
Example:

"x"

profile_picture_url
string | null
required

The URL where the profile picture of the social account can be accessed.

scopes
string[]
required

Capabilities Whop retains specific to this social account. For example, Whop may request the ability to run advertisements that use this social account's identity, reflected by the presence of advertise in this value.

url
string | null
required

The URL where the social account can be accessed on the platform. Null while a Whop-owned page is still being provisioned.

username
string | null
required

The username of the social account on the platform. Null while a Whop-owned page is still being provisioned.

verified
boolean
required

Whether the social account is verified on the platform.