The disposable email API
Create inboxes, read mail and pull verification codes from any language. One versioned surface for API keys and OAuth apps.
curl -X POST https://api.dissolve.email/v1/inboxes \
-H "Authorization: Bearer $DISSOLVE_API_KEY"import { Dissolve } from "@dissolve-email/sdk";
const dissolve = new Dissolve({ apiKey: process.env.DISSOLVE_API_KEY });
const inbox = await dissolve.inboxes.create();import os, requests
inbox = requests.post(
"https://api.dissolve.email/v1/inboxes",
headers={"Authorization": f"Bearer {os.environ['DISSOLVE_API_KEY']}"},
).json()Endpoints
Every call to /v1 carries a key (sk_live_) or an OAuth token in the Authorization header. Keys come with Pro and Business, each with its own scopes and rate limit.
- POST
/v1/inboxesCreate an inbox - GET
/v1/inboxes/:id/messagesList messages - GET
/v1/inboxes/:id/waitWait for the next message - GET
/v1/inboxes/:id/codeExtract a verification code - POST
/v1/inboxes/:id/extendExtend an inbox - POST
/v1/identitiesCreate an agent identity - GET
/v1/vaultList vault entries - DELETE
/v1/inboxes/:idDelete an inbox now
Webhooks
Get a signed POST on message.received, inbox.created and inbox.expired. Retries back off for a day, and every delivery is listed in the app.
SDK
A typed TypeScript SDK wraps every endpoint, with waiting and code extraction built in.
Limits
Pro: 100 requests a minute. Business: 1,000 requests a minute. Each response carries the remaining count.