Docs · Core concepts

Rate limits

Limits are per account, per minute. They keep sending fast and fair for everyone.

EndpointLimit

POST /v1/sms/send, POST /v1/email/send120 / min

POST /v1/sms/send-bulk10 / min

POST /v1/contacts/import5 / min

All GET endpoints300 / min

Tip: Sending to thousands of people? Use one bulk request instead of thousands of single sends. One send-bulk call can reach a whole contact group.

When you hit a limit

You get a 429 with a rate_limit_error and a Retry-After header. Wait that long, then retry.

Response headers

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 0

Response · 429

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limited",
    "message": "Too many requests. Retry after 12 seconds.",
    "request_id": "req_7Hn1sKd9Pw"
  }
}

Use a tk_test_ key while you build. Nothing is sent and no credits are used.

Was this page helpful?