Rate Limits

MailOven enforces rate limits to ensure fair usage across all organizations.

API rate limit

Scope	Limit	Window
Per API key	500 requests	1 minute
Per organization	50,000 requests	24 hours

The limit applies to all API endpoints combined. It resets every 24 hours.

When you exceed the limit, the API returns:

HTTP/1.1 429 Too Many Requests

{ "error": "API rate limit exceeded" }

Email receiving limits

Scope	Limit	Window
Per organization	2,000 emails	24 hours

Each organization can receive up to 2,000 emails per day. The counter resets every 24 hours at midnight UTC.

Invitation rate limits

Scope	Limit	Window
Per organization	10 invitations	1 hour
Per IP (acceptance)	20 requests	1 minute
Per invitation (acceptance)	10 attempts	1 hour

Tips for staying within limits

• Cache results — don't poll the same inbox repeatedly in a tight loop
• Use the since parameter — only fetch emails newer than your last check
• Clean up with DELETE /api/v1/inbox — one call instead of deleting emails individually
• Use webhooks (coming soon) — get notified when emails arrive instead of polling