---
title: "Create a Social Account"
method: POST
path: "/social_accounts"
tags: ["Social Accounts"]
---

# Create a Social Account

`POST /social_accounts`

Creates or returns a Whop-managed Facebook page for an account.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `account_id` string — The Account (biz_ identifier) to create the social account for. An account-scoped API key may omit this to default to its own account.
  - `platform` 'facebook', required — The platform to create the social account on.

## Response `200`

social account created

- SocialAccount
  - `error` string, nullable, 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.
  - `external_id` string, nullable, required — The platform-specific ID for this social account.
  - `id` string, required — Unique identifier for the social account.
  - `name` string, nullable, required — The display name of the social account on the platform.
  - `platform` 'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram', required — The platform the social account exists on.
  - `profile_picture_url` string, nullable, required — The URL where the profile picture of the social account can be accessed.
  - `scopes` string[], required
  - `url` string, nullable, required — The URL where the social account can be accessed on the platform. Null while a Whop-owned page is still being provisioned.
  - `username` string, nullable, required — The username of the social account on the platform. Null while a Whop-owned page is still being provisioned.
  - `verified` boolean, required — Whether the social account is verified on the platform.

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/a8a43db4255f/schema)