Sign in
OpenAPI 3.1.02026-08-123844095.4 MB

6fb1c04bf255

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. Account API keys cannot update their own account's branding through Update Account; use a user-authenticated path.

platform'facebook' required

The platform to create the social account on. facebook requires the account's banner_image, logo, and description; configure them with Update Account.

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

{
  "parent_social_account": {
    "platform": "x"
  },
  "platform": "x"
}