v8

OpenAPI 3.1.02026-08-033623795.0 MB
Social Accounts

Create a Social Account

Creates or returns a Whop-managed Facebook page for an account.

post/social_accounts

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

account_idstring

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

platform'facebook' required

The platform to create the social account on.

Response

social account created

errorstring nullable 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_idstring nullable required

The platform-specific ID for this social account.

idstring required

Unique identifier for the social account.

namestring nullable required

The display name of the social account on the platform.

platform'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram' required

The platform the social account exists on.

profile_picture_urlstring nullable required

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

scopesstring[] required
urlstring nullable required

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

usernamestring nullable required

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

verifiedboolean required

Whether the social account is verified on the platform.

Example response

{
  "platform": "x"
}