List accounts

GET /accounts

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

Response Example

200 — List of accounts

{
  "data": {
    "accounts": [
      {
        "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
        }
      },
      {
        "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
        }
      },
      {
        "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
        }
      }
    ]
  },
  "error": null,
  "meta": {
    "request_id": "a1b2c3d4",
    "timestamp": "2026-04-10T12:00:00.000Z"
  }
}

Account object fields

Field	Type	Description
`id`	string	Account ID (use this 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)	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