antworkDOCS

Listar cuentas

La primera llamada de cualquier integración, porque crear una publicación requiere ids de cuenta y no hay otra forma de conocerlos.

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

Petición

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

Filtra con ?workspaceId= o ?platform=.

Respuesta

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"
    }
  ]
}

La lista incluye todas las cuentas conectadas, también de plataformas en las que la API aún no puede publicar. Solo las cuentas de LinkedIn y X (Twitter) sirven en accounts al crear una publicación.

Conviene mirar tokenHealth antes de publicar. Una conexión que necesita reautorizarse falla en el momento de publicar, que puede ser días después de la petición que la programó.