Skip to content
docs
Browse the docsRate limits and plans

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

FreeProBusiness
/v1 with an API keyNo API keys100 a minute1000 a minute
/v1 through an OAuth connection (MCP, apps)30 a minute100 a minute1000 a minute
Open waits (wait and code) per credential5 at once5 at once5 at once
Longest wait in one requestNone (checks once)30 s120 s
Listing an inbox's messages5 a minute per credential5 a minute per credential5 a minute per credential
New inboxes an hour5No hourly capNo 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

Statuserror.codeWhat happenedDo
429rate_limitedThe credential used up its rate for this minute. details.limit says what it is.Wait for Retry-After (60 seconds) and slow down
429too_many_waitsFive wait or code requests are already open for this credentialWait for Retry-After (5 seconds), or let one finish
429resource_limit_exceededAn hourly cap on making something (aliases, identities, rules, labels, webhooks, webhook tests, name reservations). details holds resource, limit, used and resetAtTry again after resetAt
429resource_limit_exceededListing an inbox's messages more than five times a minute (details.resource is message polling)Use the wait endpoints instead of polling
429hourly_limit_exceededFree accounts make at most five inboxes an hourWait for details.resetAt, or upgrade
403plan_limit_exceededThe account holds as many active inboxes as the plan allowsDelete or let one expire, or upgrade
429 or 400limit_exceeded, rule_limit, label_limit, webhook_limit, template_limitA 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 inboxes31050
New inboxes an hour5UnlimitedUnlimited
Inbox lifetime10 minutes30 minutes1 hour
Extensions1 of 10 minutesUnlimited, 30 minutes each, from 15 minutes leftUnlimited, 1 hour each, from 30 minutes left
Longest inbox life20 minutes1 day3 days
Incoming mail per inbox an hour5001,0005,000
Aliases per inboxNo525
Custom inbox namesNoYesYes
Reserved namesNoNo25, held 45 days
Attachment size5 MB25 MB50 MB
Message searchNoYesYes
Email forwardingNoYesYes
WebhooksNoYesYes
Inbox rulesNo1050
LabelsNo1050
Inbox templates31025
API keysNo510
API requests a minute (API key)No1001,000
API requests a minute (OAuth connection)301001,000
Agent identitiesNo1050
Longest wait in one requestNone (checks once)30 s120 s
PersonasNoYesYes
Vault entriesNo50500
TeamsNoNo5 of up to 25 people
Priority supportNoNoYes

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