antworkDOCS

Listing accounts

The first call any integration makes, because creating a post takes account ids and there is no other way to learn them.

GEThttps://antwork.io/api/v1/accountsScoperead

Request

curl https://antwork.io/api/v1/accounts \
  -H "Authorization: Bearer $ANTWORK_API_KEY"

Narrow with ?workspaceId= or ?platform=.

Response

200 OK
{
  "object": "list",
  "accounts": [
    {
      "object": "account",
      "id": "acc_linkedin",
      "workspaceId": "ws_...",
      "platform": "linkedin",
      "name": "Iker on LinkedIn",
      "handle": "iker",
      "accountType": "personal",
      "active": true,
      "tokenHealth": "healthy",
      "connectedAt": "2026-01-05T09:00:00.000Z"
    }
  ]
}

The list includes every connected account, including platforms the API cannot post to yet. Only LinkedIn and X (Twitter) accounts can be used in accounts when creating a post.

tokenHealth is worth reading before you post. A connection that needs reauthorising fails at publish time, which may be days after the request that scheduled it.