---
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. Account API keys cannot update their own account's branding through Update Account; use a user-authenticated path.
  - `platform` 'facebook', required — The platform to create the social account on. `facebook` requires the account's `banner_image`, `logo`, and `description`; configure them with [Update Account](/api-reference/beta/accounts/update-account).

## 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.
  - `parent_social_account` SocialAccountParent, required
    - `external_id` string, nullable, required — The platform-specific ID for the parent social account.
    - `id` string, required — Social account ID, prefixed `sacc_`.
    - `name` string, nullable, required — The display name of the parent social account on the platform.
    - `platform` 'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram', required — The platform the parent social account exists on.
    - `profile_picture_url` string, nullable, required — The URL where the profile picture of the parent social account can be accessed.
    - `username` string, nullable, required — The username of the parent social account on the platform.
    - `verified` boolean, required — Whether the parent social account is verified 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
- `403` — Forbidden
- `409` — Conflict

---

[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/revisions/6a23760847c8/schema)