Sign in
OpenAPI 3.1.02026-08-193894215.9 MB

23dfbe1a0d1f

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.

Example request

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "platform": "facebook"
}

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

{
  "error": "You don't have permission to share this account. Ask an admin of its Meta Business Portfolio to grant you full control, then share it again.",
  "external_id": "1234567891",
  "id": "sacc_xxxxxxxxxxxxxx",
  "name": "Shine Time Auto Detailing",
  "parent_social_account": {
    "external_id": "555111",
    "id": "sacc_xxxxxxxxxxxxxx",
    "name": "Shine Time Auto Detailing",
    "platform": "facebook",
    "profile_picture_url": "https://shinetime.example/logo.png",
    "username": "shinetimedetailing",
    "verified": true
  },
  "platform": "instagram",
  "profile_picture_url": "https://shinetime.example/logo.png",
  "scopes": [
    "advertise"
  ],
  "url": "https://instagram.com/shinetimedetail",
  "username": "shinetimedetail",
  "verified": true
}