Reference
Rate limits and plans
Per-minute API rates for API keys and OAuth connections, wait limits, hourly caps and every plan limit, generated from the plan configuration the API enforces.
Limits come from your plan and are checked on every request, so an upgrade or a downgrade takes effect at once. The tables on this page are generated from the same plan configuration the API reads.
Request rates
| Free | Pro | Business | |
|---|---|---|---|
| /v1 with an API key | No API keys | 100 a minute | 1000 a minute |
| /v1 through an OAuth connection (MCP, apps) | 30 a minute | 100 a minute | 1000 a minute |
| Open waits (wait and code) per credential | 5 at once | 5 at once | 5 at once |
| Longest wait in one request | None (checks once) | 30 s | 120 s |
| Listing an inbox's messages | 5 a minute per credential | 5 a minute per credential | 5 a minute per credential |
| New inboxes an hour | 5 | No hourly cap | No hourly cap |
The per-minute rate belongs to the credential: each API key and each OAuth connection has its own. An API key gets the plan's API rate; an OAuth connection (an MCP client or an app) gets the plan's connection rate, which is why a Free account can use the MCP server without an API key. GET /v1/connection tells you the rate a credential has as requestsPerMinute.
Rates are applied per minute in steps of 30, 100 and 1,000. Now and then we set a higher rate for an account by agreement; it shows in requestsPerMinute like any other.
When a limit answers
| Status | error.code | What happened | Do |
|---|---|---|---|
| 429 | rate_limited | The credential used up its rate for this minute. details.limit says what it is. | Wait for Retry-After (60 seconds) and slow down |
| 429 | too_many_waits | Five wait or code requests are already open for this credential | Wait for Retry-After (5 seconds), or let one finish |
| 429 | resource_limit_exceeded | An hourly cap on making something (aliases, identities, rules, labels, webhooks, webhook tests, name reservations). details holds resource, limit, used and resetAt | Try again after resetAt |
| 429 | resource_limit_exceeded | Listing an inbox's messages more than five times a minute (details.resource is message polling) | Use the wait endpoints instead of polling |
| 429 | hourly_limit_exceeded | Free accounts make at most five inboxes an hour | Wait for details.resetAt, or upgrade |
| 403 | plan_limit_exceeded | The account holds as many active inboxes as the plan allows | Delete or let one expire, or upgrade |
| 429 or 400 | limit_exceeded, rule_limit, label_limit, webhook_limit, template_limit | A count limit of the plan (identities, vault entries, rules, labels, webhooks, templates) | Delete one first, or upgrade |
Every limit error explains itself in error.message, written to be shown to a person. See Errors for the envelope.
Plan limits
| Free ($0 a month) | Pro ($5 a month) | Business ($15 a month) | |
|---|---|---|---|
| Active inboxes | 3 | 10 | 50 |
| New inboxes an hour | 5 | Unlimited | Unlimited |
| Inbox lifetime | 10 minutes | 30 minutes | 1 hour |
| Extensions | 1 of 10 minutes | Unlimited, 30 minutes each, from 15 minutes left | Unlimited, 1 hour each, from 30 minutes left |
| Longest inbox life | 20 minutes | 1 day | 3 days |
| Incoming mail per inbox an hour | 500 | 1,000 | 5,000 |
| Aliases per inbox | No | 5 | 25 |
| Custom inbox names | No | Yes | Yes |
| Reserved names | No | No | 25, held 45 days |
| Attachment size | 5 MB | 25 MB | 50 MB |
| Message search | No | Yes | Yes |
| Email forwarding | No | Yes | Yes |
| Webhooks | No | Yes | Yes |
| Inbox rules | No | 10 | 50 |
| Labels | No | 10 | 50 |
| Inbox templates | 3 | 10 | 25 |
| API keys | No | 5 | 10 |
| API requests a minute (API key) | No | 100 | 1,000 |
| API requests a minute (OAuth connection) | 30 | 100 | 1,000 |
| Agent identities | No | 10 | 50 |
| Longest wait in one request | None (checks once) | 30 s | 120 s |
| Personas | No | Yes | Yes |
| Vault entries | No | 50 | 500 |
| Teams | No | No | 5 of up to 25 people |
| Priority support | No | No | Yes |
Prices are in US dollars. Yearly billing is $48 for Pro and $144 for Business. The pricing page has the full comparison, and Enterprise contracts are arranged by email.
Without an account
The app at app.dissolve.email lets anyone make an inbox without signing in. Those inboxes have tighter limits than Free, per network address: three active at once, three new ones an hour, the Free lifetime, and 200 incoming messages an hour each. The API itself always needs a credential.
Something wrong or missing on this page? Tell us at support@dissolve.email.View as Markdown