Skip to main content
A Social Account represents an external profile connected to a Whop account or user, such as a Facebook page or Instagram account. Connecting a social account lets Whop run ads under that profile’s identity and promote its existing posts. Use the Social Accounts API to list connected accounts, create a Whop-managed Facebook page, start an OAuth connection, disconnect a social account, and list a connected profile’s posts or a Facebook page’s lead forms.

​
Endpoints

​
Attributes

​
string
required
Unique identifier for the social account.
​
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.
​
string | null
required
The platform-specific ID for this social account.
​
string | null
required
The display name of the social account on the platform.
​
string
required
The platform the social account exists on.Available options: x, instagram, youtube, tiktok, facebook, discord, telegram
​
string | null
required
The URL where the profile picture of the social account can be accessed.
​
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.
​
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.
​
string | null
required
The username of the social account on the platform. Null while a Whop-owned page is still being provisioned.
​
boolean
required
Whether the social account is verified on the platform.
SocialAccount