> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/api-reference/beta/ads/ad) 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

| Endpoint                                                                                   | Request                                                                        |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
| [List Social Accounts](/api-reference/beta/social-accounts/list-social-accounts)           | <Badge color="blue" size="sm" stroke>GET</Badge> `/social_accounts`            |
| [Create a Social Account](/api-reference/beta/social-accounts/create-a-social-account)     | <Badge color="green" size="sm" stroke>POST</Badge> `/social_accounts`          |
| [Connect a Social Account](/api-reference/beta/social-accounts/connect-a-social-account)   | <Badge color="green" size="sm" stroke>POST</Badge> `/social_accounts/connect`  |
| [Delete a Social Account](/api-reference/beta/social-accounts/delete-a-social-account)     | <Badge color="red" size="sm" stroke>DELETE</Badge> `/social_accounts/{id}`     |
| [List Social Account Posts](/api-reference/beta/social-accounts/list-social-account-posts) | <Badge color="blue" size="sm" stroke>GET</Badge> `/social_accounts/{id}/posts` |

## Attributes

<Columns cols={2}>
  <Column>
    <ResponseField name="id" type="string" required>
      Unique identifier for the social account.
    </ResponseField>

    <ResponseField name="external_id" type="string | null" required>
      The platform-specific ID for this social account.
    </ResponseField>

    <ResponseField name="name" type="string | null" required>
      The display name of the social account on the platform.
    </ResponseField>

    <ResponseField name="platform" type="string" required>
      The platform the social account exists on.

      Available options: `x`, `instagram`, `youtube`, `tiktok`, `facebook`
    </ResponseField>

    <ResponseField name="profile_picture_url" type="string | null" required>
      The URL where the profile picture of the social account can be accessed.
    </ResponseField>

    <ResponseField name="scopes" type="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.
    </ResponseField>

    <ResponseField name="url" type="string" required>
      The URL where the social account can be accessed on the platform.
    </ResponseField>

    <ResponseField name="username" type="string" required>
      The username of the social account on the platform.
    </ResponseField>

    <ResponseField name="verified" type="boolean" required>
      Whether the social account is verified on the platform.
    </ResponseField>
  </Column>

  <Column>
    <div className="api-resource-sticky-example">
      ```json SocialAccount theme={null}
      {
      	"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
      }
      ```
    </div>
  </Column>
</Columns>