Temporary Email API

Mail.td is a Developer Email Platform with a unified REST API for creating temporary email addresses, receiving real emails, and delivering new messages in real time via WebSocket or signed Webhooks. The API is free to start — compatible with any HTTP client. Call it directly from Selenium, Cypress, Playwright, Puppeteer tests, CI/CD pipelines, or your own backend.

Workflow

Create a mailbox, receive real email over SMTP, and read messages via the REST API. Mailboxes auto-expire after 7 days.

# 1. Create a mailbox
$ curl -X POST https://api.mail.td/api/accounts \
    -H "Authorization: Bearer td_xxx" \
    -d '{"address":"user@mail.td","password":"secret"}'
→ { "id": "a1b2c3d4-...", "address": "user@mail.td" }

# 2. List incoming messages
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages \
    -H "Authorization: Bearer td_xxx"
→ { "messages": [ { "id": "f5e6d7c8-...", "from": "...", "subject": "...", "created_at": "..." } ] }

# 3. Read a message
$ curl https://api.mail.td/api/accounts/a1b2c3d4-.../messages/f5e6d7c8-... \
    -H "Authorization: Bearer td_xxx"
→ { "from": "...", "subject": "...", "text_body": "...", "html_body": "...", "attachments": [...] }

SDK & Client Libraries

Mail.td provides official SDKs in three languages. Each client fully covers the REST API with typed responses and error handling — install, authenticate with your Pro API Token, and start using it.