Documentación

Errores

Los errores siempre tienen la misma forma, con un code estable para tu código y un message legible:

json

{
  "error": {
    "code": "invalid_request",
    "message": "targets.0.tiktok: TikTok requires consent: true"
  }
}

HTTP	`code`	Qué hacer
400	`invalid_request`	Corrige la petición: el mensaje dice qué campo falla.
401	`unauthorized`	Falta la API key, es incorrecta o está revocada.
403	`forbidden`	No tienes permiso para esa operación.
402	`payment_required`	Hace falta saldo: para conectar más de 2 cuentas, o para publicar y enviar desde las cuentas a partir de la tercera o de X. Recarga en Facturación, en el panel.
404	`not_found`	El recurso no existe o es de otro workspace.
422	`provider_rejected`	La red rechazó la petición (formato, límites, permisos). El mensaje explica el motivo.
500	`internal_error`	Fallo nuestro. Reintenta y, si sigue, escríbenos.
502	`provider_unavailable`	Una red o un servicio no responde ahora. Reintenta en unos segundos.

Reintentar bien

Reintenta solo 500 y 502, con espera creciente (1 s, 2 s, 4 s…).
No reintentes los 4xx sin cambiar la petición.
Si una publicación ya se creó, usa POST /v1/posts/{id}/retry en vez de crear otra.