Errores y límites

Los errores llegan en JSON con un código fijo y un mensaje en inglés. Límite: 120 peticiones por minuto y clave, luego 429 con retry-after.

La referencia técnica de abajo está en inglés, exactamente como aparecen los nombres y campos en la API y en Claude.

{"error": {"code": "apikey_scope_fehlt", "message": "This API key does not have the scope 'contacts:write'."}}

BadRequest	Invalid request (`bad_request`, `idempotency_key_invalid`, ...)
Unauthorized	Missing or invalid API key (`unauthorized`)
Forbidden	The key lacks the required scope (`forbidden`, key `apikey_scope_fehlt`), the account is blocked (`account_blocked`), or a plan limit is reached (`limit_reached`).
NotFound	Not found (or belongs to another account)
Conflict	The current state does not allow the action (e.g. `webhook_limit_reached`, `idempotency_in_progress`)
UnprocessableEntity	Idempotency key reused with a different request body or path (`idempotency_key_mismatch`)
RateLimited	Too many requests for this key (120 per minute), code `rate_limited`
ServiceUnavailable	The account status could not be checked (`status_unavailable`). The API deliberately does NOT let the request through (fail-closed); retry in a minute.

Campo	Tipo	Obligatorio	Descripción
`error`	object	sí
`error.code`	string	sí	Stable machine code, e.g. not_found, rate_limited.
`error.key`	string	sí	Finer stable identifier for programmatic handling.
`error.message`	string	sí	Human-readable English text. Do not branch on it.

¿Preguntas?