---
title: "List connected social accounts"
method: GET
path: "/social-accounts"
tags: ["Accounts"]
---

# List connected social accounts

`GET /social-accounts`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/social-accounts`
- Auth: HTTP bearer

Requires the `accounts.read` permission.

## Headers

- `X-Workspace-Id` string

## Response `200`

Connected accounts

- object
  - `accounts` SocialAccount[]
    - `id` string: The connection id to pass in the platform's `*ConnectionIds` array. For FACEBOOK this identifies the connected page and is not the Facebook page id — see `pageId`
    - `platform` 'FACEBOOK' | 'INSTAGRAM' | 'THREADS' | 'TIKTOK' | 'TWITTER' | 'BLUESKY' | 'LINKEDIN' | 'PINTEREST' | 'YOUTUBE' | 'MASTODON' | 'TELEGRAM' | 'GOOGLE_BUSINESS' | 'TUMBLR'
    - `displayName` string
    - `username` string
    - `avatarUrl` string
    - `status` 'active' | 'unauthorized': `unauthorized` means the platform rejected the stored token: posts to this account are refused with a 400 until it is reconnected in the dashboard
    - `unauthorizedReason` string: The platform's own rejection message. Present only while `status` is `unauthorized`
    - `pageId` string: The Facebook page id. Present for FACEBOOK page accounts — accepted in `pageIds` (as is this account `id`), and returned as `pageId` and `facebookPageExternalId` on post platforms
    - `supportsInstagramAudio` boolean: INSTAGRAM only. True when the account was connected through Facebook, which Meta requires for adding Instagram audio to Reels

## Other responses

- `401`: Invalid or missing API key
- `403`: The key's role does not hold `accounts.read`
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api.md) · [All operations](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/revisions/8390a5fa9a0d?raw)