List accounts

GET /accounts

Returns all connected social media accounts for your organization, including platform, username, and health status.

Round-trip safe

The top-level account_ids array in the response is a convenience array of every account's account_id, matching the order of accounts[]. You can use individual account_id values in the account_ids field of POST /v1/posts.

Check health.can_post before posting

Just because an account appears in this list doesn't mean it can publish. Check health.can_post for each account — if false, the user needs to reconnect the account before posts will succeed. Sending a post to an unhealthy account still enqueues it, but the destination will fail immediately with a token-expired error.

Response Example

200 — List of accounts

{
  "data": {
    "accounts": [
      {
        "account_id": 2280,
        "platform": "instagram",
        "account_name": "@mybrand",
        "avatar_url": "https://example.com/avatar.jpg",
        "is_active": true,
        "created_at": "2026-01-15T10:00:00.000Z",
        "health": {
          "status": "healthy",
          "can_post": true
        }
      },
      {
        "account_id": 2282,
        "platform": "x",
        "account_name": "@mybrand",
        "avatar_url": "https://pbs.twimg.com/profile_images/abc/photo.jpg",
        "is_active": true,
        "created_at": "2026-01-15T10:05:00.000Z",
        "health": {
          "status": "healthy",
          "can_post": true
        }
      },
      {
        "account_id": 2285,
        "platform": "linkedin",
        "account_name": "My Brand Inc.",
        "avatar_url": null,
        "is_active": true,
        "created_at": "2026-02-01T08:00:00.000Z",
        "health": {
          "status": "expired",
          "can_post": false
        }
      }
    ],
    "account_ids": [2280, 2282, 2285]
  },
  "error": null,
  "meta": {
    "request_id": "a1b2c3d4",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Account object fields

Field	Type	Description
`account_id`	integer	Canonical account identifier (use in `account_ids` when creating posts)
`platform`	string	`x`, `instagram`, `facebook`, `linkedin`, `youtube`, `tiktok`, `threads`, or `pinterest`
`account_name`	string	Display name or username on the platform
`avatar_url`	string or null	Profile picture URL
`is_active`	boolean	Whether the account is active
`created_at`	string (ISO 8601)	UTC timestamp when the account was connected
`health.status`	string	`healthy`, `expired`, or `unhealthy`
`health.can_post`	boolean	Whether the account can currently publish posts

Responses

List of accounts

List accounts

/accounts

Response Example​

200 — List of accounts​

Account object fields​

Responses​

Response Example

200 — List of accounts

Account object fields

Responses