Tmailor Open API

API de e-mail temporário para testes e automação

Crie endereços de e-mail temporários somente para recebimento a partir do seu código e leia as mensagens recebidas como JSON. Cada endereço permanece na sua conta Tmailor até você excluí-lo, e a API retorna o código de uso único que encontra na mensagem.

Última atualização: October 2026

Comece grátis Leia a documentação da API

Ver planos e limites

REST e JSON
SDKs, CLI e servidor MCP
100 caixas de correio gratuitas por mês
Somente recebimento, mensagens mantidas por 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;

Crie um endereço, aguarde o e-mail, leia o código.

Pague por caixa de e-mail, não por requisição

Apenas a criação de um endereço consome sua cota de caixas de e-mail. Listar endereços, verificar a caixa de entrada e ler ou excluir mensagens não consomem. Os planos pagos não têm cota diária ou mensal de requisições, apenas um limite de requisições por minuto.

Exemplo: um teste de OTP que cria um endereço e verifica a caixa de entrada 25 vezes usa uma caixa de e-mail.

Da chave da API à caixa de entrada em quatro etapas

Crie uma chave de API
Entre na plataforma de API com sua conta tmailor.com ou com o Google e crie uma chave. No plano gratuito, adicione também o único endereço IP de servidor que fará as chamadas à API.
Crie um endereço
Envie uma requisição para obter um endereço aleatório em um domínio compartilhado, ou escolha um nome personalizado em um domínio que você possui e já verificou.
Leia as mensagens
Liste a caixa de entrada e leia cada mensagem em JSON: remetente, assunto, texto, HTML limpo e o código de uso único e os links encontrados pela API.
Mantenha ou exclua
Os endereços não expiram. Abra a mesma caixa de entrada no tmailor.com com o link de reutilização, ou exclua o endereço quando terminar o teste.

Feito para fluxos de e-mail repetíveis

Dê a cada execução de teste sua própria caixa de entrada em vez de compartilhar uma caixa de e-mail real.

Testes de cadastro e OTP

Crie um endereço novo para cada cadastro, redefinição de senha ou verificação de código único, e leia o código na resposta.

Pipelines CI/CD

Execute verificações de e-mail de ponta a ponta no seu pipeline com a chave em uma variável de ambiente. Planos pagos aceitam solicitações de qualquer endereço IP.

QA e staging

Dê aos testadores e ambientes de staging seus próprios endereços e mantenha caixas de entrada reais fora dos dados de teste.

Endereços no seu próprio domínio

Adicione um domínio seu, aponte o registro MX para nós e crie endereços com nomes personalizados que sigam as regras de nomenclatura.

Planos e preços

Escolha o número de caixas de correio que você precisa. Sua cota é renovada a cada 30 dias, inclusive nos planos anuais.

Grátis

Experimente a API e execute projetos pequenos.

$0 /mês

100 caixas de correio a cada 30 dias
Até 30 solicitações por minuto
2,000 solicitações por dia
Chamadas de um IP permitido
Domínios compartilhados e seus próprios domínios

Comece grátis

Starter

Para um desenvolvedor ou uma pequena suíte de testes.

$9 /mês

3,000 caixas de correio a cada 30 dias
Até 300 solicitações por minuto
Sem cota diária ou mensal de solicitações
Chamadas de qualquer endereço IP
Domínios compartilhados e seus próprios domínios

Escolher Starter

Pro

Para equipes que rodam testes todos os dias.

$29 /mês

30,000 caixas de correio a cada 30 dias
Até 600 solicitações por minuto
Sem cota diária ou mensal de solicitações
Chamadas de qualquer endereço IP
Domínios compartilhados e seus próprios domínios

Escolher Pro

Business

Para empresas com automação diária intensa.

$99 /mês

150,000 caixas de correio a cada 30 dias
Até 2,000 solicitações por minuto
Sem cota diária ou mensal de solicitações
Chamadas de qualquer endereço IP
Domínios compartilhados e seus próprios domínios

Escolher Business

Scale

Para grandes frotas de testes e pipelines movimentados.

$199 /mês

400,000 caixas de correio a cada 30 dias
Até 4,000 solicitações por minuto
Sem cota diária ou mensal de solicitações
Chamadas de qualquer endereço IP
Domínios compartilhados e seus próprios domínios

Escolher Scale

Enterprise

Para o maior volume de caixas de correio e a maior taxa de solicitações.

$499 /mês

2,000,000 caixas de correio a cada 30 dias
Até 6,000 solicitações por minuto
Sem cota diária ou mensal de solicitações
Chamadas de qualquer endereço IP
Domínios compartilhados e seus próprios domínios

Escolher Enterprise

Comparar planos

Esses limites variam de plano para plano. Todo o resto é igual em todos os planos.

Comparar planos
Plano	Grátis	Starter	Pro	Business	Scale	Enterprise
Preço mensal	$0	$9	$29	$99	$199	$499
Preço anual	$0	$90	$290	$990	$1,990	$4,990
Caixas de correio a cada 30 dias	100	3,000	30,000	150,000	400,000	2,000,000
Requisições por minuto	30	300	600	2,000	4,000	6,000
Limite diário de requisições	2,000	Sem limite	Sem limite	Sem limite	Sem limite	Sem limite
Lista de IPs permitidos	Obrigatório, 1 IP	Não é necessário	Não é necessário	Não é necessário	Não é necessário	Não é necessário
Servidor MCP hospedado	Somente servidor local	Incluído	Incluído	Incluído	Incluído	Incluído

Deslize para o lado para comparar todos os planos.

Incluído em todos os planos

API REST com respostas JSON
Endereços aleatórios em domínios compartilhados
Nomes personalizados em seus próprios domínios verificados
Domínios próprios ilimitados (até 3 podem aguardar verificação ao mesmo tempo)
Endereços que não expiram
Sem limite de quantos endereços você mantém
As mensagens são mantidas por 24 horas
Extração de código e link de uso único (melhor esforço)
Um link de reutilização para abrir a caixa de entrada no tmailor.com
SDKs oficiais e uma ferramenta de linha de comando
Os planos podem ser combinados e seus limites se somam
Somente recebimento, sem anexos
Excluir um endereço não devolve a cota

Quando a cota de caixas de correio se esgota, não é possível criar novos endereços até o próximo ciclo ou uma atualização. As caixas de entrada existentes continuam funcionando.
Os pagamentos não são reembolsáveis conforme os termos da API. Teste sua integração no plano gratuito primeiro.

SDKs oficiais e CLI

Chame a API na sua linguagem com modelos tipados, novas tentativas automáticas e um auxiliar que aguarda a próxima mensagem. Todos os SDKs seguem a mesma API e os mesmos cenários de teste compartilhados.

Python

Disponível

Python 3.9+

pip install tmailor-sdk

Inclui a tmailor.

Ver no PyPI Código-fonte no GitHub

Node.js

Disponível

Node.js 18+, TypeScript types

npm install tmailor

Ver no npm Código-fonte no GitHub

PHP

Disponível

PHP 8.1+

composer require tmailor/tmailor

Ver no Packagist Código-fonte no GitHub

Para agentes de IA

Servidor MCP para agentes de IA

Deixe Claude, Cursor, VS Code Copilot e outros clientes MCP testarem fluxos de cadastro que você possui ou tem permissão para testar: o agente cria um endereço real, somente de recebimento, aguarda o e-mail e lê o código de uso único ou o link de verificação.

As duas opções dão ao agente as mesmas ferramentas: criar um endereço, aguardar o e-mail e obter seu código de uso único e links, ler mensagens, excluir endereços e verificar sua cota. O agente só vê endereços de e-mail, nunca os tokens por trás deles, e usa a mesma cota de caixa de correio e o mesmo limite de requisições da API.

Servidor hospedado

Nada para instalar

https://mcp.tmailor.com/mcp

Adicione a URL do servidor ao seu app de IA. Apps que oferecem login, como Claude, ChatGPT e Codex, levam você à plataforma Tmailor para aprovar o acesso. Outros clientes enviam sua chave API no cabeçalho Authorization.

Requer um plano pago ativo. As chamadas partem do nosso servidor, então você não precisa de uma lista de IPs permitidos.

# 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_..."}}}}

Veja os apps conectados na página conexões IA e desconecte qualquer um deles. Um app desconectado perde o acesso em até 30 segundos.

Ver planos e limites

Servidor local

Todos os planos, inclusive o gratuito

tmailor-mcp

Ele roda no seu computador, lê sua chave de TMAILOR_API_KEY e precisa de uv ou Python 3.10+. No plano Gratuito, adicione o IP desse computador à lista de permissões.

# 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 no PyPI Configuração para cada cliente MCP

Experimente perguntar: "Crie um e-mail temporário, cadastre-se no meu site de staging com ele e me diga o código de verificação."

Perguntas frequentes sobre a API de e-mail temporário

O que conta como uma caixa de correio?

Cada novo endereço que você cria usa uma caixa de correio do limite do ciclo atual de 30 dias. Listar, ler e excluir não usam caixas de correio, e excluir um endereço não devolve a caixa de correio.

Os endereços expiram?

Não. Um endereço permanece na sua conta até você excluí-lo. As mensagens nele são mantidas por 24 horas.

Posso enviar e-mails ou receber anexos?

Não. A API é somente para recebimento e os anexos não são entregues.

Posso escolher o nome do endereço e o domínio?

Nos nossos domínios compartilhados, o nome é aleatório. Para escolher o nome, adicione e verifique na plataforma da API um domínio que você possui, apontando o registro MX para nós, e depois crie endereços com um nome personalizado que siga as regras de nomenclatura.

Preciso de uma lista de IPs permitidos?

Somente no plano Gratuito, em que você adiciona o único endereço IP de onde seu servidor faz as chamadas. Um endereço IP pode pertencer a apenas uma conta Free, então um endereço compartilhado de escritório ou VPN pode já estar em uso. Com um plano pago ativo, a API aceita solicitações de qualquer endereço IP.

A API lê o código de verificação para mim?

Sim, com base no melhor esforço. Quando você lê uma mensagem, a resposta inclui o código de uso único encontrado (ou null quando não há certeza), outros valores semelhantes a códigos e os links. Sempre verifique o valor no seu teste.

Agentes de IA como Claude ou ChatGPT podem usar a API?

Sim, por meio do MCP. Com um plano pago, adicione o servidor hospedado https://mcp.tmailor.com/mcp ao seu app de IA e aprove o acesso, ou envie sua chave de API. Em qualquer plano, você pode executar o servidor open-source tmailor-mcp no seu próprio computador. De qualquer forma, o agente pode criar um endereço, esperar pelo e-mail e ler o código de uso único, usando a mesma cota de caixas de correio da API.

Existe um limite de solicitações nos planos pagos?

Os planos pagos não têm cota diária ou mensal de solicitações, mas cada plano tem um limite de taxa por minuto. O plano Gratuito também tem um limite diário de solicitações.

Preciso de um cartão de crédito para começar?

Não. Entre com sua conta tmailor.com ou com o Google, crie uma chave e comece no plano Gratuito. Você só paga quando escolhe um plano pago.

Como posso pagar por um plano?

Pague com USDT nas redes TRC20 (Tron) ou BEP20 (BNB Smart Chain), ou com Binance Pay. Cartões de crédito e débito não são aceitos. Seu plano fica ativo quando o pagamento é confirmado, geralmente em poucos minutos.

Posso receber reembolso?

Não. Os pagamentos não são reembolsáveis, então teste sua integração no plano Gratuito antes de fazer upgrade.

Para que a API não é permitida?

Spam, fraude, criação de contas em massa em outros serviços e evasão de banimentos ou limites violam os termos da API. Podemos revogar as chaves de API das contas que fazem isso e bloqueá-las.

Crie seu primeiro endereço em minutos

Comece no plano Gratuito com 100 caixas de correio por mês. Não é necessário cartão de crédito.

Comece grátis Leia a documentação da API

API de e-mail temporário para testes e automação

Pague por caixa de e-mail, não por requisição

Da chave da API à caixa de entrada em quatro etapas

Crie uma chave de API

Crie um endereço

Leia as mensagens

Mantenha ou exclua

Feito para fluxos de e-mail repetíveis

Testes de cadastro e OTP

Pipelines CI/CD

QA e staging

Endereços no seu próprio domínio

Planos e preços

Grátis

Starter

Pro

Business

Scale

Enterprise

Comparar planos

Incluído em todos os planos

SDKs oficiais e CLI

Python

Node.js

PHP

Servidor MCP para agentes de IA

Servidor hospedado

Servidor local

Perguntas frequentes sobre a API de e-mail temporário

Crie seu primeiro endereço em minutos