Errores

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

{
  "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 clave API, 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 el panel, en Ajustes → Facturación. Ver Saldo y facturación.
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.