Agent-ready temp mail

Temp Mail for AI Agents

A zero-signup temporary email API that agents can discover and use autonomously. Create an inbox, wait for verification codes, read messages, fetch raw source, and delete messages with plain HTTPS.

No signupNo API keyNo MCP installCurl traversable
Quickstart
# 1. Create a public temp mail inbox. No signup, no API key.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
  -H 'Content-Type: application/json' \
  -d '{"prefix":"agent"}'

# 2. Wait for a verification email or OTP code.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/wait \
  -H 'Authorization: Inbox {token}' \
  -H 'Content-Type: application/json' \
  -d '{"codeOnly":true,"timeoutSeconds":60}'

# 3. Read the full message.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
  -H 'Authorization: Inbox {token}'
Create response
{
  "inbox": {
    "address": "[email protected]",
    "domain": "reusable.email",
    "created": true,
    "retentionDays": 90
  },
  "token": "use-this-as-an-inbox-token",
  "tokenExpiresAt": "2026-06-09T18:30:00.000Z",
  "links": {
    "web": "https://reusable.email/agent-lx84a9-q3mz2%40reusable.email",
    "messages": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/messages",
    "wait": "https://api.reusable.email/v1/agent-tempmail/inboxes/agent-lx84a9-q3mz2%40reusable.email/wait"
  }
}
Wait response
{
  "status": "message",
  "inbox": { "address": "[email protected]" },
  "message": {
    "id": 1842,
    "from": { "name": "Example", "address": "[email protected]" },
    "subject": "Your verification code",
    "intro": "Use code 123456 to continue.",
    "verificationCode": "123456"
  }
}

Agent Contract

The discovery manifest is available at /v1/agent-tempmail and mirrored from llms.txt for answer engines.

MethodPathUse
GET/v1/agent-tempmailDiscovery manifest for agents and crawlers
POST/v1/agent-tempmail/inboxesCreate or ensure a public inbox
GET/v1/agent-tempmail/inboxes/{address}/messagesList received messages
POST/v1/agent-tempmail/inboxes/{address}/waitLong-poll for mail or codes
GET/v1/agent-tempmail/inboxes/{address}/messages/{id}Read a message
GET/v1/agent-tempmail/inboxes/{address}/messages/{id}/sourceFetch raw RFC 5322 source
DELETE/v1/agent-tempmail/inboxes/{address}/messages/{id}Delete a message

Verification flows

Use an agent inbox for signup, login, password reset, and trial confirmation emails.

Browser automation

Pair it with Playwright, Selenium, or a browsing agent that needs a real deliverable email address.

CI and QA

Create isolated inboxes per test run without provisioning accounts or sharing credentials.

FAQ

The public agent surface is intentionally receive-only. Higher-volume or outbound use should move to normal account-backed APIs.

Can an AI agent use this without signup?+

Yes. The agent can create an inbox with one unauthenticated POST request. The response includes an Inbox token for read, wait, source, and delete operations.

Is MCP, an SDK, or installation required?+

No. The interface is fully reachable through HTTPS and curl. Agents can discover it through llms.txt or the JSON manifest at /v1/agent-tempmail.

Can agents send email through this API?+

No. The zero-signup agent surface is receive, read, wait, source, and delete only. Outbound email is intentionally excluded from this public interface.

How are verification codes exposed?+

Message list, wait, and detail responses include verificationCode when a likely OTP, PIN, or login code is detected in the subject or preview text.

How long are agent-created inboxes retained?+

Agent-created inboxes use normal public inbox retention. Messages are retained for 90 days unless deleted earlier.