# Disposable inboxes for code, tests and agents

> Make an email address in one call, use it in a sign-up form, read the verification code and let it dissolve. Over REST, the TypeScript SDK, the CLI or MCP.

Source: https://docs.dissolve.email/

dissolve.email gives every program its own throwaway address. An inbox lives for minutes or hours, takes mail from anyone, pulls out the verification code for you and deletes itself with every message when its time is up. It only receives: nothing can be sent from it.

This is the developer guide: the API at `https://api.dissolve.email/v1`, the [TypeScript SDK](/sdk), the [`dna` CLI](/cli), the [hosted MCP server](/mcp) for AI agents, and [signed webhooks](/webhooks). dissolve.email was called destroy.network until November 2026: [what changed](/migrating).

- Mail: [Inboxes](/inboxes), [Messages and attachments](/messages), [Codes and waiting](/verification), [Webhooks](/webhooks), [Rules and templates](/rules), [Labels](/labels)
- Accounts and teams: [Teams and shared inboxes](/teams), [API keys](/api-keys)
- Agents: [Agent identities](/agent), [Vault](/vault), [MCP server](/mcp), [MCP tools](/mcp/tools), [Playbooks](/playbooks)
- Tools: [TypeScript SDK](/sdk), [CLI](/cli)
- Reference: [API reference](/reference), [Rate limits and plans](/rate-limits), [Errors](/errors), [Support](/support)

## From nothing to a code

Make an inbox, give its address to the site you are testing, and wait for the code it sends. The wait call holds the request open until mail arrives, so there is no polling loop to write.

```bash cURL
# Make an inbox
curl -X POST https://api.dissolve.email/v1/inboxes \
  -H "Authorization: Bearer $DISSOLVE_API_KEY"

# Wait up to 30 seconds for a code from GitHub
curl "https://api.dissolve.email/v1/inboxes/$INBOX_ID/code?timeout=30&from=github.com" \
  -H "Authorization: Bearer $DISSOLVE_API_KEY"
```

```ts TypeScript
import { Dissolve } from '@dissolve-email/sdk';

const client = new Dissolve(); // reads DISSOLVE_API_KEY

const inbox = await client.v1.createInbox();
console.log(inbox.address); // use it in the sign-up form

const code = await client.v1.waitForCode(inbox.id, { timeout: 30, from: 'github.com' });
if (code.found) console.log(code.value);
```

```bash CLI
dna auth login
ID=$(dna create --label signup --json | jq -r .id)
dna verify "$ID" --timeout 30 --quiet
```

```python Python
import os, requests

API = "https://api.dissolve.email/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['DISSOLVE_API_KEY']}"}

inbox = requests.post(f"{API}/inboxes", headers=HEADERS).json()
print(inbox["address"])

code = requests.get(f"{API}/inboxes/{inbox['id']}/code", params={"timeout": 30, "from": "github.com"}, headers=HEADERS, timeout=60).json()
if code["found"]:
    print(code["value"])
```

The [quickstart](/quickstart) walks through the same steps with every answer shown.

## Ways in

| | Best for | Signs in with |
|---|---|---|
| [REST API](/reference) | Any language, test suites, back ends | An `sk_live_` API key or an OAuth token |
| [TypeScript SDK](/sdk) | Node, Deno, Bun, Workers and browsers | The same, with typed errors and retries |
| [CLI](/cli) | Shell scripts, CI jobs, agents with a terminal | `dna auth login` in the browser |
| [MCP server](/mcp) | Claude, Cursor, VS Code, ChatGPT and other agents | OAuth in the browser, or an API key |
| [Webhooks](/webhooks) | Reacting to mail without holding a request open | A signing secret you choose |

## Hosts

| Host | What lives there |
|---|---|
| `api.dissolve.email` | The API: `/v1`, the OAuth server and its discovery documents |
| `app.dissolve.email` | The app: inboxes, API keys, Connected apps, billing, the OAuth consent page |
| `mcp.dissolve.email` | The hosted MCP server |
| `docs.dissolve.email` | These docs, the [OpenAPI document](/openapi.json) and [llms.txt](/llms.txt) |
| `status.dissolve.email` | Service status and incidents |

> [!TIP] Reading this as an agent?
> Every page is also Markdown: add `.md` to its address. [llms.txt](/llms.txt) lists them all and [llms-full.txt](/llms-full.txt) holds every page in one file.
