Saltar al contenido principal
Cada API key tiene dos buckets independientes de 60 requests por minuto, contra una ventana deslizante:
  • General — lecturas, tags, mailbox, notes, files.
  • Mensajes — envíos bajo conversation.messages.* (text, quick-reply, template).
Saturar uno no afecta al otro: puedes agotar el bucket de mensajes y seguir leyendo conversaciones (y al revés).

​
Cuando se excede

Al pasar el límite la API responde 429 con código RATE_LIMIT_EXCEEDED:

​
Headers de la respuesta

Toda respuesta 429 incluye estos headers:
​
Retry-After
integer
Segundos a esperar antes de reintentar.
​
X-RateLimit-Limit
integer
El límite del bucket que aplicó al request (60 en cualquiera de los dos).
​
X-RateLimit-Remaining
integer
Requests disponibles en la ventana actual del bucket que aplicó.
​
X-RateLimit-Reset
integer
Momento en que la ventana se reinicia.

​
Cómo manejar un 429

1

Detecta el status

Trata cualquier respuesta 429 como rate limit, sin parsear el body.
2

Lee el Retry-After

Espera la cantidad de segundos que indica el header Retry-After.
3

Reintenta con backoff

Reenvía el request. Para cargas grandes (campañas), espacia los requests en vez de mandarlos en ráfaga.