Social Account

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

Endpoint	Request
List Social Accounts	GET `/social_accounts`
Create a Social Account	POST `/social_accounts`
Delete a Social Account	DELETE `/social_accounts/{id}`
List Social Account Lead Forms	GET `/social_accounts/{id}/lead_forms`
List Social Account Posts	GET `/social_accounts/{id}/posts`
Connect a Social Account	POST `/social_accounts/connect`

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.

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.

Properties

string

required

Social account ID, prefixed sacc_.

string | null

required

The platform-specific ID for the parent social account.

string | null

required

The display name of the parent social account on the platform.

string

required

The platform the parent social account exists on.Available options: x, instagram, youtube, tiktok, facebook, discord, telegram

string | null

required

The URL where the profile picture of the parent social account can be accessed.

string | null

required

The username of the parent social account on the platform.

boolean

required

Whether the parent social account is verified 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

{
	"id": "sacc_xxxxxxxxxxxx",
	"external_id": "17841400000000000",
	"name": "Pickaxe Pro",
	"parent_social_account": {
		"id": "sacc_yyyyyyyyyyyy",
		"platform": "facebook",
		"username": "pickaxepro",
		"name": "Pickaxe Pro",
		"profile_picture_url": "https://img.whop.com/sacc_yyyyyyyyyyyy.png",
		"verified": true,
		"external_id": "112233445566778"
	},
	"platform": "instagram",
	"profile_picture_url": "https://img.whop.com/sacc_xxxxxxxxxxxx.png",
	"scopes": ["advertise"],
	"error": null,
	"url": "https://instagram.com/pickaxepro",
	"username": "pickaxepro",
	"verified": true
}

Introduction

Reference

Webhooks & events

Core Resources

Notifications

Money

Commerce

Partners

Workforce

Tracking

Ads

Media

Identity

Developer

Endpoints

Attributes

​Endpoints

​Attributes

Endpoints

Attributes