API de Email Temporal

API REST unificada para desarrolladores: crea direcciones de temp mail, recibe emails reales.

Mail.td es infraestructura de email para desarrolladores, con una API REST unificada para crear direcciones de temporary email, recibir emails reales y entregar nuevos mensajes en tiempo real vía WebSocket o Webhooks firmados. La API es gratis para empezar — compatible con cualquier cliente HTTP. Llámala directamente desde tests de Selenium, Cypress, Playwright, Puppeteer, pipelines CI/CD o tu propio backend.

Flujo de trabajo

Crea un buzón, recibe emails reales por SMTP y lee los mensajes a través de la API REST. Los buzones expiran automáticamente después de 7 días.

# 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 y bibliotecas cliente

Mail.td proporciona SDKs oficiales en tres lenguajes. Cada cliente cubre completamente la API REST con respuestas tipadas y manejo de errores — instala, autentica con tu Pro API Token y empieza a usarlo.

Node.js / TypeScript

npm install mailtd

Cliente sin dependencias usando fetch nativo, con definiciones de tipos TypeScript completas.

Python

pip install mailtd

Cliente basado en HTTP con tipos dataclass y soporte para async context manager.

Go

go get github.com/mailtd/mailtd-go

Solo stdlib, ciclo de vida de peticiones basado en context, structs totalmente tipados.

Notas importantes Los emails del plan Pro se conservan 7 días y luego se eliminan automáticamente (consulta la página de precios para la retención del plan gratuito). Mail.td está diseñado para pruebas de email, automatización QA y uso temporal de desarrolladores — no como un buzón de correo a largo plazo.