# 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.

Source: https://docs.dissolve.email/rate-limits

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](/mcp) without an API key. [GET /v1/connection](/reference/account#describe-this-credential) 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](/verification) 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](/errors) for the envelope.

> [!TIP] Wait, do not poll
> A loop that lists messages every second hits the polling cap within the minute. [GET /v1/inboxes/{id}/wait](/reference/waiting#wait-for-a-message) holds one request open until mail arrives and costs one request.

## 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](https://dissolve.email/pricing) 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.
