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.

​
Endpoints

EndpointRequest
List Social AccountsGET /social_accounts
Create a Social AccountPOST /social_accounts
Connect a Social AccountPOST /social_accounts/connect
Delete a Social AccountDELETE /social_accounts/{id}
List Social Account PostsGET /social_accounts/{id}/posts

​
Attributes

​
id
string
required
Unique identifier for the social account.
​
external_id
string | null
required
The platform-specific ID for this social account.
​
name
string | null
required
The display name of the social account on the platform.
​
platform
string
required
The platform the social account exists on.Available options: x, instagram, youtube, tiktok, facebook
​
profile_picture_url
string | null
required
The URL where the profile picture of the social account can be accessed.
​
scopes
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.
​
url
string
required
The URL where the social account can be accessed on the platform.
​
username
string
required
The username of the social account on the platform.
​
verified
boolean
required
Whether the social account is verified on the platform.
SocialAccount
{
	"id": "sacc_xxxxxxxxxxxx",
	"external_id": "17841400000000000",
	"name": "Pickaxe Pro",
	"platform": "instagram",
	"profile_picture_url": "https://img.whop.com/sacc_xxxxxxxxxxxx.png",
	"scopes": ["advertise"],
	"url": "https://instagram.com/pickaxepro",
	"username": "pickaxepro",
	"verified": true
}