Current limits
Bulk write endpoints include:
POST /lead-lists/{id}/enrich, POST /campaigns/{id}/leads (when lead_list_id is used).
Response headers
Every response includes rate-limit headers:Handling 429s
When you hit a rate limit:- Read the
Retry-Afterheader - Wait that many seconds before retrying
- Use exponential backoff for sustained high-volume workloads
Tips for staying under limits
- Paginate efficiently, use the
cursorparam on list endpoints instead of fetching all pages at once - Batch lead enrollment, use
lead_list_idinstead of individuallead_idsarrays - Cache read responses, analytics and agent configs change infrequently
- Webhook over polling, register webhook endpoints instead of polling the jobs or conversations API