Skip to main content
Two kinds of limit apply to every send:
  • Send limits cap how fast an inbox sends, to anyone.
  • Cold outreach cap limits how many new recipients you email per UTC day. Starts low and grows as you build history.
Replies and follow-ups only meet the first. Cold outreach meets both.

Send limits

Over one of these, the API returns 429 with a Retry-After header:

Cold outreach cap

A recipient is new the first time an inbox emails an address that has never written to it. Each To/Cc address counts once; Bcc, your own inboxes, and anyone who has already emailed or been emailed by that inbox don’t count. Warmth is per inbox, so a contact known to inbox A is still new to inbox B.
Three caps apply at once. The lowest one you reach is the one that blocks.Custom domain tiers. Each domain climbs on its own. Both columns are counted from the day you added the domain to OpenMail; how long you’ve owned it doesn’t matter. Inboxes on the shared omail.sh domain have no domain cap.To grow your caps
  1. Send to new recipients most days. The account cap follows your trailing average, and a domain’s tier needs volume as well as age.
  2. Keep bounces under 5% and complaints under 0.1%. Anything worse throttles the inbox, and at 10% bounces or 0.3% complaints suspends it; see Reputation.
  3. Get replies. Cold threads that get a human reply are what let the account cap keep doubling.
Need volume before the history exists? Contact us about a trusted volume for a vetted use case.

When you get a 429

1

Read the scope

inbox, domain or customer (your account). It tells you which cap you hit, so you know whether another inbox or domain would help. On a domain block, another inbox on the same domain won’t.
2

Pause cold sends until resetsAt

Caps reset at midnight UTC. Retrying earlier fails the same way. There’s no endpoint for today’s remaining allowance yet, so treat the 429 as the signal.
3

Keep replying

The rejected send didn’t go out and didn’t count. Replies and follow-ups to existing contacts are unaffected, so your agents can keep working threads.

Reputation

Every inbox has a reputation state: good, watch, throttled or suspended. It’s computed from the inbox’s permanent bounces and spam complaints over the trailing 7 days. Keep bounces under 5% and complaints under 0.1% and the inbox stays in good, with full caps.

Thresholds

What each state does

If an inbox is suspended

  1. Fix what caused the bounces or complaints: validate the list, check DNS, drop the source.
  2. Contact us for review.
  3. Wait for the inbox.reactivated webhook before sending again.
For how to send so you never meet these limits, read Email deliverability.