Accounts API

The /v1/accounts endpoint returns the social accounts the authenticated user has access to. You'll need account IDs to target posts.

Requires authentication.

---

List accounts

GET /api/v1/accounts

Returns the connected social accounts the authenticated user can post to (those they own or are a member of via an organization).

Example

curl https://<your-api-origin>/api/v1/accounts \
  -H "Authorization: Bearer gx_live_YOUR_API_KEY"

Response — 200 OK

{
  "data": [
    {
      "id": "acc_abc123",
      "platform": "instagram",
      "username": "postbuzz",
      "displayName": "post.buzz"
    },
    {
      "id": "acc_def456",
      "platform": "x",
      "username": "postbuzz",
      "displayName": "post.buzz"
    }
  ]
}

Fields

Field	Description
id	The account ID. Use this as accountId when creating posts.
platform	One of the supported platforms (e.g. instagram, x).
username	The handle/username on the platform.
displayName	The display name, where available.

Disconnected accounts (those with a disconnectedAt timestamp) are excluded — only active accounts are returned.

Related

• Posts API — use these account IDs to create posts.
• Platforms — capability and limit reference.