Skip to main content

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:
  1. Read the Retry-After header
  2. Wait that many seconds before retrying
  3. Use exponential backoff for sustained high-volume workloads

Tips for staying under limits

  • Paginate efficiently, use the cursor param on list endpoints instead of fetching all pages at once
  • Batch lead enrollment, use lead_list_id instead of individual lead_ids arrays
  • Cache read responses, analytics and agent configs change infrequently
  • Webhook over polling, register webhook endpoints instead of polling the jobs or conversations API