Create a Social Account
Creates or returns a Whop-managed Facebook page for an account.
Authorizations
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
A unique key that makes this request safe to retry. See Idempotent requests.
255"d9105228-4a08-46b1-8b91-42fed586d383"
Pins the request to a dated API version.
"2026-08-13"
Body
The platform to create the social account on. facebook requires the account's banner_image, logo, and description; configure them with Update Account.
facebook "facebook"
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.
"biz_xxxxxxxxxxxxxx"
Response
social account created
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.
"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."
The platform-specific ID for this social account.
"1234567891"
Unique identifier for the social account.
"sacc_xxxxxxxxxxxxxx"
The display name of the social account on the platform.
"Shine Time Auto Detailing"
The social account this one belongs to on the platform, such as the Facebook page that owns an Instagram account. Null when the social account stands on its own.
The platform the social account exists on.
x, instagram, youtube, tiktok, facebook, discord, telegram "instagram"
The URL where the profile picture of the social account can be accessed.
"https://shinetime.example/logo.png"
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.
The URL where the social account can be accessed on the platform. Null while a Whop-owned page is still being provisioned.
"https://instagram.com/shinetimedetail"
The username of the social account on the platform. Null while a Whop-owned page is still being provisioned.
"shinetimedetail"
Whether the social account is verified on the platform.
true

