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, y cualquiera sirve para crear una publicación: la API publica en X (Twitter), LinkedIn, Facebook, Threads, Instagram, YouTube Shorts, TikTok, Pinterest, Bluesky, Discord, Mastodon, Telegram, Google Business Profile y Slack.

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ó.

¿Algo no cuadra? Dinos cuál.