Tmailor Open API

API per temp mail per test e automazione

Crea dal tuo codice indirizzi email temporanei solo in ricezione e leggi i messaggi in arrivo in formato JSON. Ogni indirizzo resta nel tuo account Tmailor finché non lo elimini, e l'API restituisce il codice monouso che trova in un messaggio.

Ultimo aggiornamento: October 2026

Inizia gratis Leggi la documentazione API

Vedi piani e limiti

REST e JSON
SDK, CLI e server MCP
100 caselle di posta gratuite al mese
Solo ricezione, messaggi conservati 24 ore

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 un indirizzo, aspetta l'email, leggi il codice.

Paghi per casella, non per richiesta

Solo la creazione di un indirizzo consuma la quota di caselle. Elencare gli indirizzi, controllare la casella di posta e leggere o eliminare i messaggi non la consuma. I piani a pagamento non hanno una quota di richieste giornaliera o mensile, ma solo un limite di richieste al minuto.

Esempio: un test OTP che crea un indirizzo e controlla la casella di posta 25 volte utilizza una sola casella.

Dalla chiave API alla casella di posta in quattro passaggi

Crea una chiave API
Accedi alla piattaforma API con il tuo account tmailor.com o con Google e crea una chiave. Nel piano gratuito, aggiungi anche l'unico indirizzo IP del server che chiamerà l'API.
Crea un indirizzo
Invia una richiesta per ottenere un indirizzo casuale su un dominio condiviso, oppure scegli un nome personalizzato su un dominio di tua proprietà che hai verificato.
Leggi i messaggi
Elenca la casella di posta e leggi ogni messaggio in formato JSON: mittente, oggetto, testo, HTML ripulito e il codice monouso e i link individuati dall'API.
Conservalo o eliminalo
Gli indirizzi non scadono. Apri la stessa casella di posta su tmailor.com con il link di riutilizzo, oppure elimina l'indirizzo quando il test è finito.

Pensato per flussi di lavoro email ripetibili

Assegna a ogni esecuzione dei test una casella di posta dedicata invece di condividere un'unica casella reale.

Test di registrazione e OTP

Crea un nuovo indirizzo per ogni registrazione, reimpostazione della password o verifica del codice monouso, poi leggi il codice dalla risposta.

Pipeline CI/CD

Esegui controlli email end-to-end nella tua pipeline con la chiave in una variabile d'ambiente. I piani a pagamento accettano richieste da qualsiasi indirizzo IP.

QA e staging

Assegna ai tester e agli ambienti di staging indirizzi dedicati e tieni le caselle di posta reali fuori dai dati di test.

Indirizzi sul tuo dominio

Aggiungi un dominio che possiedi, punta il suo record MX verso di noi e crea indirizzi con nomi personalizzati che rispettino le regole di denominazione.

Piani e prezzi

Scegli il numero di caselle di posta che ti serve. La tua quota si rinnova ogni 30 giorni, anche con i piani annuali.

Gratis

Prova l'API e realizza piccoli progetti.

$0 /mese

100 caselle ogni 30 giorni
Fino a 30 richieste al minuto
2,000 richieste al giorno
Chiamate da un IP in allowlist
Domini condivisi e domini tuoi

Inizia gratis

Starter

Per uno sviluppatore o una piccola suite di test.

$9 /mese

3,000 caselle ogni 30 giorni
Fino a 300 richieste al minuto
Nessun limite giornaliero o mensile di richieste
Chiamate da qualsiasi indirizzo IP
Domini condivisi e domini tuoi

Scegli Starter

Pro

Per i team che eseguono test ogni giorno.

$29 /mese

30,000 caselle ogni 30 giorni
Fino a 600 richieste al minuto
Nessun limite giornaliero o mensile di richieste
Chiamate da qualsiasi indirizzo IP
Domini condivisi e domini tuoi

Scegli Pro

Business

Per aziende con un'automazione quotidiana intensa.

$99 /mese

150,000 caselle ogni 30 giorni
Fino a 2,000 richieste al minuto
Nessun limite giornaliero o mensile di richieste
Chiamate da qualsiasi indirizzo IP
Domini condivisi e domini tuoi

Scegli Business

Scale

Per grandi flotte di test e pipeline molto attive.

$199 /mese

400,000 caselle ogni 30 giorni
Fino a 4,000 richieste al minuto
Nessun limite giornaliero o mensile di richieste
Chiamate da qualsiasi indirizzo IP
Domini condivisi e domini tuoi

Scegli Scale

Enterprise

Per il massimo volume di caselle e la frequenza di richieste più alta.

$499 /mese

2,000,000 caselle ogni 30 giorni
Fino a 6,000 richieste al minuto
Nessun limite giornaliero o mensile di richieste
Chiamate da qualsiasi indirizzo IP
Domini condivisi e domini tuoi

Scegli Enterprise

Confronta i piani

Questi limiti cambiano da piano a piano. Tutto il resto è identico su ogni piano.

Confronta i piani
Piano	Gratis	Starter	Pro	Business	Scale	Enterprise
Prezzo mensile	$0	$9	$29	$99	$199	$499
Prezzo annuale	$0	$90	$290	$990	$1,990	$4,990
Caselle ogni 30 giorni	100	3,000	30,000	150,000	400,000	2,000,000
Richieste al minuto	30	300	600	2,000	4,000	6,000
Limite giornaliero di richieste	2,000	Nessun limite	Nessun limite	Nessun limite	Nessun limite	Nessun limite
Allowlist IP	Obbligatoria, 1 IP	Non necessaria	Non necessaria	Non necessaria	Non necessaria	Non necessaria
Server MCP ospitato	Solo server locale	Incluso	Incluso	Incluso	Incluso	Incluso

Scorri lateralmente per confrontare tutti i piani.

Incluso in ogni piano

API REST con risposte JSON
Indirizzi casuali su domini condivisi
Nomi personalizzati sui tuoi domini verificati
Domini propri illimitati (fino a 3 possono essere in attesa di verifica contemporaneamente)
Indirizzi che non scadono
Nessun limite al numero di indirizzi che puoi mantenere
I messaggi vengono conservati per 24 ore
Estrazione di codici monouso e link (best effort)
Un link per riaprire la casella di posta su tmailor.com
SDK ufficiali e uno strumento da riga di comando
I piani possono essere combinati e i loro limiti si sommano
Solo ricezione, senza allegati
Eliminare un indirizzo non restituisce la quota

Quando la quota di caselle è esaurita, non è possibile creare nuovi indirizzi fino al ciclo successivo o a un upgrade. Le caselle esistenti continuano a funzionare.
I pagamenti non sono rimborsabili secondo i termini API. Prova prima la tua integrazione con il piano gratuito.

SDK ufficiali e CLI

Chiama l'API dal tuo linguaggio con modelli tipizzati, nuovi tentativi automatici e un helper che attende il messaggio successivo. Ogni SDK segue la stessa API e gli stessi scenari di test condivisi.

Python

Disponibile

Python 3.9+

pip install tmailor-sdk

Include lo tmailor da riga di comando.

Visualizza su PyPI Codice sorgente su GitHub

Node.js

Disponibile

Node.js 18+, TypeScript types

npm install tmailor

Visualizza su npm Codice sorgente su GitHub

PHP

Disponibile

PHP 8.1+

composer require tmailor/tmailor

Visualizza su Packagist Codice sorgente su GitHub

Per gli agenti IA

Server MCP per agenti IA

Consenti a Claude, Cursor, VS Code Copilot e ad altri client MCP di testare i flussi di registrazione che possiedi o che sei autorizzato a testare: l'agente crea un indirizzo reale, di sola ricezione, attende l'email e legge il codice monouso o il link di verifica.

Entrambe le opzioni offrono all'agente gli stessi strumenti: creare un indirizzo, attendere l'email e ottenere il codice monouso e i link, leggere i messaggi, eliminare gli indirizzi e controllare la quota. L'agente vede solo gli indirizzi email, mai i token che vi stanno dietro, e utilizza la stessa quota di caselle e lo stesso limite di frequenza dell'API.

Server ospitato

Niente da installare

https://mcp.tmailor.com/mcp

Aggiungi l'URL del server alla tua app AI. Le app che supportano l'accesso, come Claude, ChatGPT e Codex, ti rimandano alla piattaforma Tmailor per approvare l'accesso. Gli altri client inviano la tua chiave API nell'intestazione Authorization.

Richiede un piano a pagamento attivo. Le chiamate provengono dal nostro server, quindi non serve un elenco di IP consentiti.

# 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 le app connesse nella pagina AI connection e disconnetti quelle che vuoi. Un'app disconnessa perde l'accesso entro 30 secondi.

Vedi piani e limiti

Server locale

Tutti i piani, incluso quello gratuito

tmailor-mcp

Viene eseguito sul tuo computer, legge la chiave da TMAILOR_API_KEY e richiede uv o Python 3.10+. Nel piano Free, aggiungi l'IP di quel computer alla allowlist.

# 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

Visualizza su PyPI Configurazione per ogni client MCP

Prova a chiedere: "Crea un'email temporanea, registrati sul mio sito di staging con essa e dimmi il codice di verifica."

FAQ sull'API di posta temporanea

Cosa conta come casella di posta?

Ogni nuovo indirizzo che crei utilizza una casella di posta dalla quota del ciclo attuale di 30 giorni. Elencare, leggere ed eliminare non consumano caselle di posta, e eliminare un indirizzo non restituisce la casella di posta.

Gli indirizzi scadono?

No. Un indirizzo rimane nel tuo account finché non lo elimini. I messaggi al suo interno sono conservati per 24 ore.

Posso inviare email o ricevere allegati?

No. L'API è solo in ricezione e gli allegati non vengono consegnati.

Posso scegliere il nome dell'indirizzo e il dominio?

Sui nostri domini condivisi il nome è casuale. Per scegliere il nome, aggiungi e verifica sulla piattaforma API un dominio di tua proprietà puntando il suo record MX a noi, poi crea indirizzi con un nome personalizzato che rispetti le regole di denominazione.

Serve una lista di IP consentiti?

Solo con il piano gratuito, dove aggiungi l'unico indirizzo IP da cui il tuo server effettua le chiamate. Un indirizzo IP può appartenere a un solo account gratuito, quindi un indirizzo condiviso di ufficio o VPN potrebbe essere già in uso. Con un piano a pagamento attivo, l'API accetta richieste da qualsiasi indirizzo IP.

L'API legge il codice di verifica al posto mio?

Sì, per quanto possibile. Quando leggi un messaggio, la risposta include il codice monouso trovato (o null quando non è sicuro), altri valori simili a un codice e i link. Verifica sempre il valore nel tuo test.

Gli agenti AI come Claude o ChatGPT possono usare l'API?

Sì, tramite MCP. Con un piano a pagamento, aggiungi il server ospitato https://mcp.tmailor.com/mcp alla tua app AI e approva l'accesso, oppure invia la tua chiave API. Con qualsiasi piano, puoi eseguire il server open-source tmailor-mcp sul tuo computer. In entrambi i casi, l'agente può creare un indirizzo, attendere l'email e leggere il codice monouso, usando la stessa quota di caselle di posta dell'API.

C'è un limite di richieste sui piani a pagamento?

I piani a pagamento non hanno una quota giornaliera o mensile di richieste, ma ogni piano ha un limite di frequenza al minuto. Il piano gratuito ha anche un tetto giornaliero di richieste.

Serve una carta di credito per iniziare?

No. Accedi con il tuo account tmailor.com o con Google, crea una chiave e inizia con il piano gratuito. Paghi solo quando scegli un piano a pagamento.

Come posso pagare un piano?

Paga con USDT sulla rete TRC20 (Tron) o BEP20 (BNB Smart Chain), oppure con Binance Pay. Le carte di credito e di debito non sono accettate. Il tuo piano diventa attivo quando il pagamento viene confermato, di solito entro pochi minuti.

Posso ottenere un rimborso?

No. I pagamenti non sono rimborsabili, quindi prova la tua integrazione con il piano gratuito prima di passare a un piano a pagamento.

Per cosa non è consentito usare l'API?

Spam, frode, creazione massiva di account su altri servizi ed elusione dei loro ban o limiti violano i termini dell'API. Possiamo revocare le chiavi API degli account che lo fanno e bloccarli.

Crea il tuo primo indirizzo in pochi minuti

Inizia con il piano gratuito con 100 caselle di posta al mese. Non è richiesta la carta di credito.

Inizia gratis Leggi la documentazione API

API per temp mail per test e automazione

Paghi per casella, non per richiesta

Dalla chiave API alla casella di posta in quattro passaggi

Crea una chiave API

Crea un indirizzo

Leggi i messaggi

Conservalo o eliminalo

Pensato per flussi di lavoro email ripetibili

Test di registrazione e OTP

Pipeline CI/CD

QA e staging

Indirizzi sul tuo dominio

Piani e prezzi

Gratis

Starter

Pro

Business

Scale

Enterprise

Confronta i piani

Incluso in ogni piano

SDK ufficiali e CLI

Python

Node.js

PHP

Server MCP per agenti IA

Server ospitato

Server locale

FAQ sull'API di posta temporanea

Crea il tuo primo indirizzo in pochi minuti