429 rate_limited with a Retry-After header.
Headers
Every response carries:Staying under it
- Use the batch endpoints.
POST /v1/emails/batchandPOST /v1/sms/batchsend up to 1,000 messages and count as one request. - Retry with backoff on 429 and on connection errors, with the same
Idempotency-Keyso a retry never sends twice. The SDK throwsSendbazeErrorwithstatus: 429andSendbazeConnectionErrorfor network failures. - Queue on your side. For campaigns, pull from your own queue at a steady rate rather than firing thousands of parallel requests.