---
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.
    - `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

---

[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/db0883548bc5/schema)