Tmailor Open API

API de correo temporal para pruebas y automatización

Crea direcciones de correo temporal de solo recepción desde tu código y lee los mensajes entrantes como JSON. Cada dirección permanece en tu cuenta de Tmailor hasta que la eliminas, y la API devuelve el código de un solo uso que encuentra en un mensaje.

Última actualización: October 2026

Empieza gratis Lee la documentación de la API

Ver planes y límites

REST y JSON
SDKs, CLI y servidor MCP
100 buzones gratuitos al mes
Solo recepción, mensajes durante 24 horas

export TMAILOR_API_KEY="tmk_live_..."

# returns 201 with email, token, web.reuse_url
curl -s -X POST https://open-api.tmailor.com/v1/mailboxes \
  -H "Authorization: Bearer $TMAILOR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{}'

# pip install tmailor-sdk
from tmailor import Client

with Client() as client:  # reads TMAILOR_API_KEY
    box = client.mailboxes.create()
    print(box.email)

    # trigger the email, then wait for it
    msg = box.wait_for_message(
        timeout=120, since=(box.created_at or 0) - 1)
    print(msg.subject, msg.otp(), msg.links())

// npm install tmailor
import { Client } from "tmailor";

const client = new Client(); // reads TMAILOR_API_KEY
const box = await client.mailboxes.create();
console.log(box.email);

// trigger the email, then wait for it
const msg = await box.waitForMessage({
  timeout: 120_000, since: box.createdAt - 1 });
console.log(msg.subject, msg.otp, msg.links);

<?php // composer require tmailor/tmailor
use Tmailor\Client;

$client = new Client(); // reads TMAILOR_API_KEY
$box = $client->mailboxes->create();
echo $box->email, "\n";

// trigger the email, then wait for it
$msg = $box->waitForMessage(
    timeout: 120, since: $box->createdAt - 1);
echo $msg->subject, ' ', $msg->otp;

Crea una dirección, espera el correo y lee el código.

Paga por buzón, no por solicitud

Solo crear una dirección consume tu cuota de buzones. Consultar direcciones, revisar la bandeja de entrada y leer o eliminar mensajes no la consumen. Los planes de pago no tienen cuota diaria ni mensual de solicitudes, solo un límite de peticiones por minuto.

Ejemplo: una prueba OTP que crea una dirección y consulta la bandeja de entrada 25 veces usa un solo buzón.

De la clave API a la bandeja de entrada en cuatro pasos

Crea una clave API
Inicia sesión en la plataforma API con tu cuenta de tmailor.com o con Google y crea una clave. En el plan gratuito, añade también la única dirección IP del servidor que llamará a la API.
Crea una dirección
Envía una solicitud para obtener una dirección aleatoria en un dominio compartido, o elige un nombre personalizado en un dominio que poseas y hayas verificado.
Lee los mensajes
Enumera la bandeja de entrada y lee cada mensaje como JSON: remitente, asunto, texto, HTML saneado y el código de un solo uso y los enlaces que encontró la API.
Consérvala o elimínala
Las direcciones no caducan. Abre la misma bandeja de entrada en tmailor.com con su enlace de reutilización, o elimina la dirección cuando termines tu prueba.

Diseñado para flujos de correo repetibles

Dale a cada ejecución de prueba su propia bandeja de entrada en lugar de compartir un buzón real.

Registro y pruebas OTP

Crea una dirección nueva para cada registro, restablecimiento de contraseña o comprobación de código de un solo uso, y luego lee el código de la respuesta.

Pipelines de CI/CD

Ejecuta comprobaciones de correo de extremo a extremo en tu pipeline con la clave en una variable de entorno. Los planes de pago aceptan solicitudes desde cualquier dirección IP.

QA y staging

Da a los testers y a los entornos de staging sus propias direcciones y mantén los buzones reales fuera de los datos de prueba.

Direcciones en tu propio dominio

Añade un dominio que posees, apunta su registro MX hacia nosotros y crea direcciones con nombres personalizados que sigan las reglas de nombres.

Planes y precios

Elige el número de buzones que necesitas. Tu cuota se renueva cada 30 días, también en los planes anuales.

Gratis

Prueba la API y ejecuta proyectos pequeños.

$0 /mes

100 buzones cada 30 días
Hasta 30 solicitudes por minuto
2,000 solicitudes por día
Llamadas desde una IP permitida
Dominios compartidos y tus propios dominios

Empieza gratis

Starter

Para un desarrollador o una pequeña suite de pruebas.

$9 /mes

3,000 buzones cada 30 días
Hasta 300 solicitudes por minuto
Sin cuota diaria ni mensual de solicitudes
Llamadas desde cualquier dirección IP
Dominios compartidos y tus propios dominios

Elige Starter

Pro

Para equipos que ejecutan pruebas todos los días.

$29 /mes

30,000 buzones cada 30 días
Hasta 600 solicitudes por minuto
Sin cuota diaria ni mensual de solicitudes
Llamadas desde cualquier dirección IP
Dominios compartidos y tus propios dominios

Elige Pro

Business

Para empresas con una intensa automatización diaria.

$99 /mes

150,000 buzones cada 30 días
Hasta 2,000 solicitudes por minuto
Sin cuota diaria ni mensual de solicitudes
Llamadas desde cualquier dirección IP
Dominios compartidos y tus propios dominios

Elige Business

Scale

Para grandes flotas de pruebas y pipelines muy activos.

$199 /mes

400,000 buzones cada 30 días
Hasta 4,000 solicitudes por minuto
Sin cuota diaria ni mensual de solicitudes
Llamadas desde cualquier dirección IP
Dominios compartidos y tus propios dominios

Elige Scale

Enterprise

Para el mayor volumen de buzones y la mayor tasa de solicitudes.

$499 /mes

2,000,000 buzones cada 30 días
Hasta 6,000 solicitudes por minuto
Sin cuota diaria ni mensual de solicitudes
Llamadas desde cualquier dirección IP
Dominios compartidos y tus propios dominios

Elige Enterprise

Comparar planes

Estos límites varían según el plan. Todo lo demás es igual en todos los planes.

Comparar planes
Plan	Gratis	Starter	Pro	Business	Scale	Enterprise
Precio mensual	$0	$9	$29	$99	$199	$499
Precio anual	$0	$90	$290	$990	$1,990	$4,990
Buzones cada 30 días	100	3,000	30,000	150,000	400,000	2,000,000
Solicitudes por minuto	30	300	600	2,000	4,000	6,000
Límite diario de solicitudes	2,000	Sin límite	Sin límite	Sin límite	Sin límite	Sin límite
Lista de IP permitidas	Obligatoria, 1 IP	No hace falta	No hace falta	No hace falta	No hace falta	No hace falta
Servidor MCP alojado	Solo servidor local	Incluido	Incluido	Incluido	Incluido	Incluido

Desliza hacia un lado para comparar todos los planes.

Incluido en todos los planes

API REST con respuestas JSON
Direcciones aleatorias en dominios compartidos
Nombres personalizados en tus propios dominios verificados
Dominios propios ilimitados (hasta 3 pueden estar pendientes de verificación a la vez)
Direcciones que no caducan
Sin límite en la cantidad de direcciones que conservas
Los mensajes se conservan durante 24 horas
Extracción de códigos de un solo uso y enlaces (según disponibilidad)
Un enlace de reutilización para abrir la bandeja de entrada en tmailor.com
SDKs oficiales y una herramienta de línea de comandos
Los planes pueden combinarse y sus límites se suman
Solo recepción, sin archivos adjuntos
Eliminar una dirección no devuelve cuota

Cuando se agota la cuota de buzones, no se pueden crear direcciones nuevas hasta el siguiente ciclo o hasta una mejora de plan. Las bandejas de entrada existentes siguen funcionando.
Los pagos no son reembolsables según los términos de la API. Prueba primero tu integración en el plan gratuito.

SDK oficiales y CLI

Llama a la API desde tu propio lenguaje con modelos tipados, reintentos automáticos y un asistente que espera el siguiente mensaje. Todos los SDK siguen la misma API y los mismos escenarios de prueba compartidos.

Python

Disponible

Python 3.9+

pip install tmailor-sdk

Incluye la tmailor.

Ver en PyPI Código en GitHub

Node.js

Disponible

Node.js 18+, TypeScript types

npm install tmailor

Ver en npm Código en GitHub

PHP

Disponible

PHP 8.1+

composer require tmailor/tmailor

Ver en Packagist Código en GitHub

Para agentes de IA

Servidor MCP para agentes de IA

Permite que Claude, Cursor, VS Code Copilot y otros clientes MCP prueben flujos de registro que te pertenecen o que tienes permiso para probar: el agente crea una dirección real de solo recepción, espera el correo y lee el código de un solo uso o el enlace de verificación.

Ambas opciones ofrecen al agente las mismas herramientas: crear una dirección, esperar el correo y obtener su código de un solo uso y sus enlaces, leer mensajes, eliminar direcciones y consultar tu cuota. El agente solo ve direcciones de correo, nunca los tokens que hay detrás, y usa la misma cuota de buzón y límite de solicitudes que la API.

Servidor alojado

Nada que instalar

https://mcp.tmailor.com/mcp

Añade la URL del servidor a tu app de IA. Las apps que admiten inicio de sesión, como Claude, ChatGPT y Codex, te redirigen a la plataforma Tmailor para aprobar el acceso. Otros clientes envían tu clave API en la cabecera Authorization.

Requiere un plan de pago activo. Las llamadas se realizan desde nuestro servidor, así que no necesitas una lista de IP permitidas.

# Claude: add a custom connector with this URL,
# then approve access on the Tmailor platform
https://mcp.tmailor.com/mcp

# Claude Code, with your API key
claude mcp add --transport http tmailor \
  https://mcp.tmailor.com/mcp \
  --header "Authorization: Bearer tmk_live_..."

# Codex CLI, with your API key
export TMAILOR_API_KEY=tmk_live_...
codex mcp add tmailor \
  --url https://mcp.tmailor.com/mcp \
  --bearer-token-env-var TMAILOR_API_KEY

# Cursor (~/.cursor/mcp.json)
{"mcpServers": {"tmailor": {
  "url": "https://mcp.tmailor.com/mcp",
  "headers": {"Authorization": "Bearer tmk_live_..."}}}}

Consulta las aplicaciones conectadas en la página de AI connections y desconecta cualquiera de ellas. Una app desconectada pierde el acceso en menos de 30 segundos.

Ver planes y límites

Servidor local

Todos los planes, incluido el gratuito

tmailor-mcp

Se ejecuta en tu ordenador, lee tu clave de TMAILOR_API_KEY y necesita uv o Python 3.10+. En el plan gratuito, añade la IP de ese ordenador a la lista de permitidas.

# Claude Code
claude mcp add tmailor \
  -e TMAILOR_API_KEY=tmk_live_... \
  -- uvx tmailor-mcp

# Claude Desktop, Cursor, VS Code
#   command: uvx   args: ["tmailor-mcp"]

# without uv
pip install tmailor-mcp

Ver en PyPI Configuración para cada cliente MCP

Prueba a preguntar: "Crea un correo temporal, regístrate con él en mi sitio de pruebas y dime el código de verificación."

Preguntas frecuentes sobre la API de correo temporal

¿Qué cuenta como buzón?

Cada nueva dirección que creas utiliza un buzón del límite del ciclo actual de 30 días. Listar, leer y eliminar no consumen buzones, y eliminar una dirección no devuelve el buzón.

¿Caducan las direcciones?

No. Una dirección permanece en tu cuenta hasta que la eliminas. Los mensajes que contiene se guardan durante 24 horas.

¿Puedo enviar correos o recibir archivos adjuntos?

No. La API es solo de recepción y no se entregan archivos adjuntos.

¿Puedo elegir el nombre de la dirección y el dominio?

En nuestros dominios compartidos el nombre es aleatorio. Para elegir el nombre, añade y verifica en la plataforma de la API un dominio que poseas apuntando su registro MX hacia nosotros, y luego crea direcciones con un nombre personalizado que siga las reglas de nomenclatura.

¿Necesito una lista de IP permitidas?

Solo en el plan gratuito, donde añades la única dirección IP desde la que llama tu servidor. Una dirección IP solo puede pertenecer a una cuenta gratuita, por lo que una dirección de oficina compartida o de VPN puede que ya esté en uso. Con un plan de pago activo, la API acepta solicitudes desde cualquier dirección IP.

¿La API lee el código de verificación por mí?

Sí, en la medida de lo posible. Cuando lees un mensaje, la respuesta incluye el código de un solo uso que encontró (o null cuando no está seguro), otros valores similares a códigos y los enlaces. Comprueba siempre el valor en tu prueba.

¿Pueden usar la API agentes de IA como Claude o ChatGPT?

Sí, a través de MCP. Con un plan de pago, añade el servidor alojado https://mcp.tmailor.com/mcp a tu app de IA y aprueba el acceso, o envía tu clave API. Con cualquier plan, puedes ejecutar el servidor de código abierto tmailor-mcp en tu propio ordenador. En ambos casos, el agente puede crear una dirección, esperar el correo y leer el código de un solo uso, usando la misma cuota de buzones que la API.

¿Hay un límite de solicitudes en los planes de pago?

Los planes de pago no tienen cuota diaria ni mensual de solicitudes, pero cada plan tiene un límite de velocidad por minuto. El plan gratuito también tiene un límite diario de solicitudes.

¿Necesito una tarjeta de crédito para empezar?

No. Inicia sesión con tu cuenta de tmailor.com o de Google, crea una clave y empieza con el plan gratuito. Solo pagas cuando eliges un plan de pago.

¿Cómo puedo pagar un plan?

Paga con USDT en la red TRC20 (Tron) o BEP20 (BNB Smart Chain), o con Binance Pay. No se aceptan tarjetas de crédito ni de débito. Tu plan se activa cuando se confirma el pago, normalmente en pocos minutos.

¿Puedo obtener un reembolso?

No. Los pagos no son reembolsables, así que prueba tu integración en el plan gratuito antes de actualizar.

¿Para qué no está permitida la API?

El spam, el fraude, la creación masiva de cuentas en otros servicios y la evasión de sus bloqueos o límites infringen los términos de la API. Podemos revocar las claves API de las cuentas que hagan esto y bloquearlas.

Crea tu primera dirección en minutos

Empieza con el plan gratuito con 100 buzones al mes. No se requiere tarjeta de crédito.

Empieza gratis Lee la documentación de la API

API de correo temporal para pruebas y automatización

Paga por buzón, no por solicitud

De la clave API a la bandeja de entrada en cuatro pasos

Crea una clave API

Crea una dirección

Lee los mensajes

Consérvala o elimínala

Diseñado para flujos de correo repetibles

Registro y pruebas OTP

Pipelines de CI/CD

QA y staging

Direcciones en tu propio dominio

Planes y precios

Gratis

Starter

Pro

Business

Scale

Enterprise

Comparar planes

Incluido en todos los planes

SDK oficiales y CLI

Python

Node.js

PHP

Servidor MCP para agentes de IA

Servidor alojado

Servidor local

Preguntas frecuentes sobre la API de correo temporal

Crea tu primera dirección en minutos