Skip to main content
POST
TypeScript

인증

Authorization
string
header
필수

An Account API key, an App API key, an account access token, an account-scoped user token, or a user OAuth token. Prepend the key or token with Bearer, for example Bearer ***************************. See Auth & API keys for how to get each one.

Scopes

social_account:create

헤더

Idempotency-Key
string

A unique key that makes this request safe to retry. See Idempotent requests.

Maximum string length: 255
예시:

"d9105228-4a08-46b1-8b91-42fed586d383"

Api-Version-Date
string

Pins the request to a dated API version.

예시:

"2026-11-17"

본문

application/json

Whop no longer creates Facebook pages, so this returns a facebook_page_provisioning_retired error.

platform
enum<string>
필수

The platform to create the external account on.

사용 가능한 옵션:
facebook
예시:

"facebook"

account_id
string

The Account (biz_ identifier) to create the external 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"

응답

social account created through the deprecated path

error
string | null
필수

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.

예시:

null

external_id
string | null
필수

The platform-specific ID for this social account.

예시:

"17841479809129315"

id
string
필수

Unique identifier for the social account.

예시:

"sacc_xxxxxxxxxxxxxx"

name
string | null
필수

The display name of the social account on the platform.

예시:

"Shine Time Detail"

parent_social_account
object | null
필수

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, or when it is a partner.

partnership_status
string | null
필수

Always null. Partnership ads are no longer available.

예시:

null

platform
enum<string>
필수

The platform the social account exists on.

사용 가능한 옵션:
x,
instagram,
youtube,
tiktok,
facebook,
discord,
telegram,
linkedin,
snapchat,
klaviyo,
quickbooks,
aimerce
예시:

"instagram"

profile_picture_url
string | null
필수

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

예시:

"https://shinetime.example/instagram.png"

scopes
string[]
필수

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 advertise. Personal profile connections have no additional Whop scopes.

url
string | null
필수

The URL where the social account can be accessed on the platform. Null while a Whop-owned account is still being provisioned.

예시:

"https://instagram.com/shinetimedetail"

username
string | null
필수

The username of the social account on the platform. Null while a Whop-owned account is still being provisioned, and on platforms without usernames, such as Klaviyo.

예시:

"shinetimedetail"

verified
boolean
필수

Whether the social account is verified on the platform.

예시:

true