Correo temporal para agentes de IA
Una API de correo temporal sin registro que los agentes pueden descubrir y usar de forma autónoma. Crea una bandeja de entrada, espera códigos de verificación, lee mensajes, obtén su código fuente y elimínalos mediante HTTPS.
# Descubre los dominios disponibles:
curl -s https://api.reusable.email/v1/agent-tempmail/domains
# 1. Crea una bandeja de correo temporal privada. Sin registro ni clave API.
curl -s -X POST https://api.reusable.email/v1/agent-tempmail/inboxes \
-H 'Content-Type: application/json' \
-d '{"prefix":"agent"}'
# 2. Espera un correo de verificación o un código OTP.
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. Lee el mensaje completo.
curl -s https://api.reusable.email/v1/agent-tempmail/inboxes/{address}/messages/{id} \
-H 'Authorization: Inbox {token}'{
"inbox": {
"address": "agent-lx84a9-q3mz2@reusable.email",
"domain": "reusable.email",
"created": true,
"type": "private",
"isProtected": true,
"retentionDays": 180
},
"password": "save-this-generated-password-securely",
"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": "agent-lx84a9-q3mz2@reusable.email" },
"message": {
"id": 1842,
"from": { "name": "Example", "address": "login@example.com" },
"subject": "Your verification code",
"intro": "Use code 123456 to continue.",
"verificationCode": "123456"
}
}Interfaz para agentes
El manifiesto de descubrimiento está disponible en /v1/agent-tempmail y se refleja en llms.txt para los motores de respuesta.
| Método | Ruta | Uso |
|---|---|---|
| GET | /v1/agent-tempmail | Manifiesto de descubrimiento para agentes y rastreadores |
| GET | /v1/agent-tempmail/domains | Enumerar los dominios alternativos disponibles |
| POST | /v1/agent-tempmail/inboxes | Crea una bandeja de entrada privada protegida con contraseña |
| GET | /v1/agent-tempmail/inboxes/{address}/messages | Enumerar los mensajes recibidos |
| POST | /v1/agent-tempmail/inboxes/{address}/wait | Esperar correo o códigos mediante long polling |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Lee un mensaje |
| GET | /v1/agent-tempmail/inboxes/{address}/messages/{id}/source | Obtener el mensaje original en formato RFC 5322 |
| DELETE | /v1/agent-tempmail/inboxes/{address}/messages/{id} | Eliminar un mensaje |
Flujos de verificación
Utiliza una bandeja de entrada de agente para los correos electrónicos de registro, inicio de sesión, restablecimiento de contraseña y confirmación de prueba.
Automatización del navegador
Combínalo con Playwright, Selenium o un agente de navegación que necesite una dirección de correo electrónico real.
CI y QA
Crea bandejas aisladas para cada ejecución de pruebas sin crear cuentas ni compartir credenciales.
Preguntas frecuentes
Crear una bandeja de entrada privada es gratis y no requiere registro. Para elegir un dominio alternativo, pasa uno de los dominios del endpoint de lista. La interfaz para agentes solo recibe correo. Para mayor volumen o envío de correo, utiliza las API normales asociadas a una cuenta.
¿Puedo usar una clave de acceso con la bandeja de entrada de un agente?+
Sí. Inicia sesión con la contraseña generada y añade una clave de acceso en la configuración de la bandeja. El botón con el icono de llave del formulario de bandeja privada y la pantalla de desbloqueo admiten el inicio de sesión con clave de acceso. El token Inbox resultante funciona con todos los endpoints del buzón para agentes. Las claves de acceso requieren verificación interactiva del usuario; conserva la contraseña para los agentes que funcionen sin supervisión y renueva los tokens caducados con POST /v1/inbox/{address}/token y JSON {"password":"..."}.
¿Puedo elegir un dominio alternativo?+
Sí. GET /v1/agent-tempmail/domains enumera los dominios disponibles. Indica domain junto con prefix o un address que contenga solo la parte anterior a la arroba, o proporciona un address completo. No se pueden registrar direcciones existentes o reservadas.
¿Puede un agente de IA usar esto sin registrarse?+
Sí. El agente puede crear una bandeja de entrada con una solicitud POST sin autenticación. La respuesta incluye una contraseña generada y un Inbox token. Todas las bandejas creadas son privadas. Guarda la contraseña para iniciar sesión normalmente después de que caduque el token.
¿Se requiere MCP, un SDK o instalación?+
No. Se puede acceder a toda la interfaz mediante HTTPS y curl. Los agentes pueden descubrirla a través de llms.txt o del manifiesto JSON en /v1/agent-tempmail.
¿Pueden los agentes enviar correo a través de esta API?+
No. La interfaz para agentes sin registro solo permite recibir, leer, esperar, obtener el código fuente y eliminar mensajes. El envío de correo está excluido deliberadamente de esta interfaz pública.
¿Cómo se exponen los códigos de verificación?+
Las respuestas de lista, espera y detalle priorizan las cabeceras experimentales OTP-Token válidas; si no las hay, buscan códigos en el texto. Los códigos procedentes de cabeceras incluyen verificationCodeOrigin: antes de enviar el código, comprueba que el esquema, el host y el puerto coincidan exactamente con el origen del destino previsto. Este valor lo proporciona el remitente y no demuestra su identidad. Nunca navegues automáticamente a una dirección indicada por el remitente.
¿Cuánto tiempo se conservan las bandejas de entrada creadas por el agente?+
Las bandejas de entrada creadas por el agente tienen capacidades normales de bandeja de entrada privada y retención de mensajes de 180 días.