- 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.
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.- Pro
- Free
- Enterprise
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
- Send to new recipients most days. The account cap follows your trailing average, and a domain’s tier needs volume as well as age.
- 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.
- Get replies. Cold threads that get a human reply are what let the account cap keep doubling.
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
- Fix what caused the bounces or complaints: validate the list, check DNS, drop the source.
- Contact us for review.
- Wait for the
inbox.reactivatedwebhook before sending again.