---
title: "List Social Accounts"
method: GET
path: "/social_accounts"
tags: ["Social Accounts"]
---

# List Social Accounts

`GET /social_accounts`

Lists the social accounts linked to an account or user.

## Query parameters

- `account_id` string
- `user_id` string
- `platform` 'x' | 'instagram' | 'youtube' | 'tiktok' | 'facebook' | 'discord' | 'telegram'
- `verified` boolean
- `scopes` string[]
- `first` integer
- `after` string
- `last` integer
- `before` string
- `order` 'display_order' | 'created_at'
- `direction` 'asc' | 'desc'

## Response `200`

filtered to accounts holding the requested scope

- object
  - `data` SocialAccount[], required
    - `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.
  - `page_info` object, required
    - `end_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required

## Other responses

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

## Changes

> 43 revisions in range; 1 not diffed.

- **2026-08-11** `a01100378e59` — 1 info
  - added the required property `data/items/parent_social_account` to the response with the `200` status
- **2026-08-07** `f1020c3ecda4` — 2 info
  - added the optional property `error/code` to the response with the `400` status
  - added the optional property `error/code` to the response with the `401` status
- **2026-07-26** `60bbb4a6ffbc` — 2 warning, 3 info
  - added the new `discord` enum value to the `data/items/platform` response property for the response status `200`
  - added the new `telegram` enum value to the `data/items/platform` response property for the response status `200`
  - added the new enum value `discord` to the `query` request parameter `platform`
  - added the new enum value `telegram` to the `query` request parameter `platform`
  - …1 more
- **2026-07-14** `3a06a605784b` — 2 breaking
  - the response property `data/items/url` became nullable for the status `200`
  - the response property `data/items/username` became nullable for the status `200`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/social_accounts/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/ac73c486e4fd/schema)