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

# List connected social media accounts

`GET /connected-accounts`

## Request

- Base URL: `https://www.sociahive.com/api/v1`
- URL: `https://www.sociahive.com/api/v1/connected-accounts`
- Auth: one of:
  - API key in header `X-API-Key`
  - OAuth 2 (authorization code, authorization URL `/api/oauth/authorize`, token URL `/api/oauth/token`, scopes: `accounts:read`)

Returns all social media accounts the authenticated user has connected. Use these account IDs when creating posts and flows.

## Query parameters

- `platform` 'instagram' | 'messenger' | 'whatsapp' | 'linkedin' | 'twitter' | 'tiktok' | 'telegram' | 'threads' | 'youtube' | 'bluesky' | 'pinterest' | 'facebook': Connected-account platform identifier

## Response `200`

Connected accounts

- object
  - `data` ConnectedAccount[], required
    - `id` string, required: MongoDB ObjectId (24-character hex string)
    - `platform` string, required: Platform id. Known values: `instagram`, `messenger`, `whatsapp`, `linkedin`, `twitter`, `tiktok`, `telegram`, `threads`, `youtube`, `bluesky`, `pinterest`, `facebook`, `discord`, `mastodon`, `lemmy`, `devto`, `hashnode`, `wordpress`, `listmonk`, `slack`, `tumblr`, `dribbble`, `twitch`, `kick`. Treat any other value as unknown, never as an error.
    - `platform_user_id` string, required
    - `platform_username` string
    - `display_name` string
    - `is_active` boolean, required
    - `created_at` string, date-time, required
    - `text_limit` integer: Most characters a post on this account may have. X is 280, or more for an X Premium account where long posts are on (rolling out).
  - `selected_account_id` string, nullable: The account to open on when this client has no choice of its own: the one the user last picked on any device, else the oldest connected account. Null when there is none.

## Other responses

- `400`: Bad request — invalid parameters
- `401`: Authentication required — provide X-API-Key or Bearer token
- `403`: Insufficient scope for this operation
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/sociahive/apis/sociahive-api.md) · [All operations](https://skmtc.dev/sociahive/apis/sociahive-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sociahive/apis/sociahive-api/revisions/791b8548d288?raw)