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.
# 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}'{
"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"
}
}{
"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.
| Method | Path | Use |
|---|---|---|
| GET | /v1/agent-tempmail | Discovery manifest for agents and crawlers |
| POST | /v1/agent-tempmail/inboxes | Create or ensure a public inbox |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | List received messages |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Long-poll for mail or codes |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Read a message |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Fetch 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.
