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

# List connected social accounts

`GET /accounts`

## Query parameters

- `platform` 'instagram' | 'facebook' | 'linkedin' | 'linkedin_page' | 'youtube' | 'tiktok' | 'pinterest' | 'bluesky' | 'threads' | 'mastodon' | 'x' | 'google_business' | 'reddit' | 'snapchat'

## Response `200`

List of connected accounts

- object
  - `data` Account[]
    - `id` string — Account ID (use this when creating posts)
    - `platform` 'instagram' | 'facebook' | 'linkedin' | 'linkedin_page' | 'youtube' | 'tiktok' | 'pinterest' | 'bluesky' | 'threads' | 'mastodon' | 'x' | 'google_business' | 'reddit' | 'snapchat'
    - `username` string — Social media username/handle
    - `display_name` string — Display name on the platform
    - `profile_picture` string — Profile picture URL
    - `content_types` string[] — Supported content types for this platform
    - `status` 'active' | 'needs_reconnect' — Connection status. `needs_reconnect` means the account is still wired up to the workspace but its OAuth token has been revoked or expired; posts to this account will fail until the user reconnects in the OmniSocials UI. Most often caused by the user changing their password, deauthorizing OmniSocials on the platform, or the token expiring without a successful refresh.
    - `needs_reconnect` boolean — Convenience boolean — `true` when `status` is `needs_reconnect`.
    - `reauth_reason` string, nullable — Short reason from the platform (e.g. "OAuthException: Session has expired"). Present only when `needs_reconnect` is true. Token-health tracking exists for Instagram, Facebook, Threads, X, Pinterest, LinkedIn (profile + page); other platforms always report `needs_reconnect: false`.
    - `boards` object[] — Pinterest boards (only present for Pinterest accounts). Use board `id` as `board_id` when creating Pinterest posts.
      - `id` string — Board ID (use as board_id when creating posts)
      - `name` string — Board name
    - `platform_details` object — Platform-specific details. Present for X accounts with Premium subscription.
      - `subscription_type` string — X subscription tier (e.g. "Premium", "PremiumPlus")
    - `connected_at` string, date-time
  - `workspace_id` integer — Stable id of the active workspace this key belongs to.
  - `workspace_name` string, nullable — Human-readable name of the active workspace.
  - `workspace_icon` string, nullable

---

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