Tmailor Open API

API de temp mail pour les tests et l’automatisation

Créez des adresses e-mail temporaires en réception seule depuis votre code et lisez les messages entrants au format JSON. Chaque adresse reste dans votre compte Tmailor jusqu’à ce que vous la supprimiez, et l’API renvoie le code à usage unique qu’elle trouve dans un message.

Dernière mise à jour : October 2026

Commencer gratuitement Lire la documentation de l’API

Voir les offres et les limites

REST et JSON
SDK, CLI et serveur MCP
100 boîtes aux lettres gratuites par mois
Réception uniquement, messages conservés 24 h

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;

Créez une adresse, attendez l’e-mail, lisez le code.

Payez par boîte aux lettres, pas par requête

Seule la création d’une adresse consomme votre quota de boîtes aux lettres. Lister les adresses, consulter la boîte de réception et lire ou supprimer des messages ne le consomment pas. Les forfaits payants n’ont pas de quota de requêtes journalier ou mensuel, seulement une limite de débit par minute.

Exemple : un test OTP qui crée une adresse et consulte la boîte de réception 25 fois n’utilise qu’une seule boîte aux lettres.

De la clé API à la boîte de réception en quatre étapes

Créer une clé API
Connectez-vous à la plateforme API avec votre compte tmailor.com ou Google et créez une clé. Avec le forfait Gratuit, ajoutez également l’unique adresse IP du serveur qui appellera l’API.
Créer une adresse
Envoyez une requête pour obtenir une adresse aléatoire sur un domaine partagé, ou choisissez un nom personnalisé sur un domaine que vous possédez et avez vérifié.
Lire les messages
Listez la boîte de réception et lisez chaque message au format JSON : expéditeur, objet, texte, HTML nettoyé, ainsi que le code à usage unique et les liens détectés par l’API.
La conserver ou la supprimer
Les adresses n’expirent pas. Ouvrez la même boîte de réception sur tmailor.com avec son lien de réutilisation, ou supprimez l’adresse une fois votre test terminé.

Conçu pour des workflows e-mail répétables

Donnez à chaque exécution de test sa propre boîte de réception au lieu de partager une vraie boîte aux lettres.

Inscription et tests OTP

Créez une nouvelle adresse pour chaque inscription, réinitialisation de mot de passe ou vérification de code à usage unique, puis lisez le code dans la réponse.

Pipelines CI/CD

Lancez des vérifications d’e-mail de bout en bout dans votre pipeline avec la clé dans une variable d’environnement. Les forfaits payants acceptent les requêtes depuis n’importe quelle adresse IP.

QA et préproduction

Donnez aux testeurs et aux environnements de préproduction leurs propres adresses et tenez les vraies boîtes de réception à l’écart des données de test.

Adresses sur votre propre domaine

Ajoutez un domaine que vous possédez, pointez son enregistrement MX vers nous et créez des adresses avec des noms personnalisés respectant les règles de nommage.

Offres et tarifs

Choisissez le nombre de boîtes aux lettres dont vous avez besoin. Votre quota est réinitialisé tous les 30 jours, y compris pour les forfaits annuels.

Gratuit

Essayez l’API et lancez de petits projets.

$0 /mois

100 boîtes aux lettres tous les 30 jours
Jusqu’à 30 requêtes par minute
2,000 requêtes par jour
Appels depuis une IP autorisée
Domaines partagés et vos propres domaines

Commencer gratuitement

Starter

Pour un développeur ou une petite suite de tests.

$9 /mois

3,000 boîtes aux lettres tous les 30 jours
Jusqu’à 300 requêtes par minute
Aucun quota de requêtes quotidien ou mensuel
Appels depuis n’importe quelle adresse IP
Domaines partagés et vos propres domaines

Choisir Starter

Pro

Pour les équipes qui lancent des tests tous les jours.

$29 /mois

30,000 boîtes aux lettres tous les 30 jours
Jusqu’à 600 requêtes par minute
Aucun quota de requêtes quotidien ou mensuel
Appels depuis n’importe quelle adresse IP
Domaines partagés et vos propres domaines

Choisir Pro

Business

Pour les entreprises à l’automatisation quotidienne intensive.

$99 /mois

150,000 boîtes aux lettres tous les 30 jours
Jusqu’à 2,000 requêtes par minute
Aucun quota de requêtes quotidien ou mensuel
Appels depuis n’importe quelle adresse IP
Domaines partagés et vos propres domaines

Choisir Business

Scale

Pour de grandes flottes de tests et des pipelines très sollicités.

$199 /mois

400,000 boîtes aux lettres tous les 30 jours
Jusqu’à 4,000 requêtes par minute
Aucun quota de requêtes quotidien ou mensuel
Appels depuis n’importe quelle adresse IP
Domaines partagés et vos propres domaines

Choisir Scale

Enterprise

Pour le plus grand volume de boîtes aux lettres et le débit de requêtes le plus élevé.

$499 /mois

2,000,000 boîtes aux lettres tous les 30 jours
Jusqu’à 6,000 requêtes par minute
Aucun quota de requêtes quotidien ou mensuel
Appels depuis n’importe quelle adresse IP
Domaines partagés et vos propres domaines

Choisir Enterprise

Comparez les forfaits

Ces limites varient d’un forfait à l’autre. Tout le reste est identique sur chaque forfait.

Comparez les forfaits
Forfait	Gratuit	Starter	Pro	Business	Scale	Enterprise
Prix mensuel	$0	$9	$29	$99	$199	$499
Prix annuel	$0	$90	$290	$990	$1,990	$4,990
Boîtes aux lettres tous les 30 jours	100	3,000	30,000	150,000	400,000	2,000,000
Requêtes par minute	30	300	600	2,000	4,000	6,000
Plafond de requêtes par jour	2,000	Aucun plafond	Aucun plafond	Aucun plafond	Aucun plafond	Aucun plafond
Liste d’IP autorisées	Obligatoire, 1 IP	Non requise	Non requise	Non requise	Non requise	Non requise
Serveur MCP hébergé	Serveur local uniquement	Inclus	Inclus	Inclus	Inclus	Inclus

Faites glisser horizontalement pour comparer tous les forfaits.

Inclus dans chaque forfait

API REST avec réponses JSON
Adresses aléatoires sur des domaines partagés
Noms personnalisés sur vos propres domaines vérifiés
Domaines personnels illimités (jusqu’à 3 peuvent être en attente de vérification en même temps)
Adresses qui n’expirent pas
Aucune limite au nombre d’adresses que vous conservez
Les messages sont conservés pendant 24 heures
Extraction des codes à usage unique et des liens (au mieux)
Un lien de réutilisation pour ouvrir la boîte de réception sur tmailor.com
SDK officiels et un outil en ligne de commande
Les forfaits peuvent être combinés et leurs limites s’additionnent
Réception uniquement, sans pièces jointes
Supprimer une adresse ne restitue pas le quota

Une fois le quota de boîtes aux lettres épuisé, il n'est plus possible de créer de nouvelles adresses avant le prochain cycle ou une mise à niveau. Les boîtes de réception existantes continuent de fonctionner.
Les paiements ne sont pas remboursables, conformément aux conditions API. Testez d'abord votre intégration avec le forfait Gratuit.

SDK officiels et CLI

Appelez l’API depuis votre langage avec des modèles typés, des nouvelles tentatives automatiques et un assistant qui attend le prochain message. Chaque SDK suit la même API et les mêmes scénarios de test partagés.

Python

Disponible

Python 3.9+

pip install tmailor-sdk

Inclut tmailor en ligne de commande.

Voir sur PyPI Code source sur GitHub

Node.js

Disponible

Node.js 18+, TypeScript types

npm install tmailor

Voir sur npm Code source sur GitHub

PHP

Disponible

PHP 8.1+

composer require tmailor/tmailor

Voir sur Packagist Code source sur GitHub

Pour les agents IA

Serveur MCP pour les agents IA

Laissez Claude, Cursor, VS Code Copilot et d’autres clients MCP tester les parcours d’inscription que vous possédez ou êtes autorisé à tester : l’agent crée une véritable adresse en réception seule, attend l’e-mail et lit le code à usage unique ou le lien de vérification.

Les deux options donnent à l’agent les mêmes outils : créer une adresse, attendre l’e-mail et récupérer son code à usage unique et ses liens, lire les messages, supprimer les adresses et vérifier votre quota. L’agent ne voit que les adresses e-mail, jamais les tokens associés, et il utilise le même quota de boîte aux lettres et la même limite de débit que l’API.

Serveur hébergé

Rien à installer

https://mcp.tmailor.com/mcp

Ajoutez l’URL du serveur à votre application IA. Les applications qui prennent en charge la connexion, telles que Claude, ChatGPT et Codex, vous redirigent vers la plateforme Tmailor pour approuver l’accès. Les autres clients envoient votre clé API dans l’en-tête Authorization.

Nécessite un forfait payant actif. Les appels proviennent de notre serveur, vous n’avez donc pas besoin d’une liste d’adresses IP autorisées.

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

Consultez les applications connectées sur la page connexions IA et déconnectez celles de votre choix. Une application déconnectée perd l’accès en moins de 30 secondes.

Voir les offres et les limites

Serveur local

Tous les forfaits, y compris gratuit

tmailor-mcp

Il s’exécute sur votre ordinateur, lit votre clé depuis TMAILOR_API_KEY et nécessite uv ou Python 3.10+. Avec le forfait gratuit, ajoutez l’IP de cet ordinateur à la liste d’autorisation.

# 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

Voir sur PyPI Configuration pour chaque client MCP

Essayez de demander : « Crée un e-mail temporaire, inscris-toi sur mon site de préproduction avec et donne-moi le code de vérification. »

FAQ sur l’API de messagerie temporaire

Qu’est-ce qui compte comme une boîte aux lettres ?

Chaque nouvelle adresse créée consomme une boîte aux lettres sur le quota du cycle de 30 jours en cours. La liste, la lecture et la suppression ne consomment pas de boîte aux lettres, et supprimer une adresse ne restitue pas la boîte aux lettres.

Les adresses expirent-elles ?

Non. Une adresse reste dans votre compte jusqu’à ce que vous la supprimiez. Les messages qu’elle contient sont conservés pendant 24 heures.

Puis-je envoyer des e-mails ou recevoir des pièces jointes ?

Non. L’API est uniquement en réception et les pièces jointes ne sont pas livrées.

Puis-je choisir le nom de l’adresse et le domaine ?

Sur nos domaines partagés, le nom est aléatoire. Pour choisir le nom, ajoutez et vérifiez un domaine que vous possédez sur la plateforme API en pointant son enregistrement MX vers nous, puis créez des adresses avec un nom personnalisé qui respecte les règles de nommage.

Ai-je besoin d’une liste d’IP autorisées ?

Uniquement avec le forfait gratuit, où vous ajoutez l’adresse IP depuis laquelle votre serveur appelle. Une adresse IP ne peut être associée qu’à un seul compte gratuit, donc une adresse partagée de bureau ou de VPN peut déjà être utilisée. Avec un forfait payant actif, l’API accepte les requêtes de n’importe quelle adresse IP.

L’API lit-elle le code de vérification à ma place ?

Oui, au mieux de ses capacités. Lorsque vous lisez un message, la réponse inclut le code à usage unique détecté (ou null lorsqu’il n’est pas sûr), d’autres valeurs de type code et les liens. Vérifiez toujours la valeur dans votre test.

Les agents IA comme Claude ou ChatGPT peuvent-ils utiliser l’API ?

Oui, via MCP. Avec un forfait payant, ajoutez le serveur hébergé https://mcp.tmailor.com/mcp à votre application IA et approuvez l’accès, ou envoyez votre clé API. Quel que soit le forfait, vous pouvez exécuter le serveur open source tmailor-mcp sur votre propre ordinateur. Dans les deux cas, l’agent peut créer une adresse, attendre l’e-mail et lire le code à usage unique, en utilisant le même quota de boîtes aux lettres que l’API.

Y a-t-il une limite de requêtes sur les forfaits payants ?

Les forfaits payants n’ont pas de quota de requêtes journalier ou mensuel, mais chaque forfait a une limite de débit par minute. Le forfait gratuit a également un plafond de requêtes journalier.

Ai-je besoin d’une carte bancaire pour commencer ?

Non. Connectez-vous avec votre compte tmailor.com ou Google, créez une clé et commencez avec le forfait gratuit. Vous ne payez que lorsque vous choisissez un forfait payant.

Comment puis-je payer un forfait ?

Payez en USDT sur le réseau TRC20 (Tron) ou BEP20 (BNB Smart Chain), ou avec Binance Pay. Les cartes de crédit et de débit ne sont pas acceptées. Votre forfait devient actif dès que le paiement est confirmé, généralement en quelques minutes.

Puis-je obtenir un remboursement ?

Non. Les paiements ne sont pas remboursables, alors testez votre intégration avec le forfait gratuit avant de passer à un forfait payant.

Quels usages de l’API sont interdits ?

Le spam, la fraude, la création massive de comptes sur d’autres services et le contournement de leurs bannissements ou limites enfreignent les conditions de l’API. Nous pouvons révoquer les clés API des comptes qui font cela et les verrouiller.

Créez votre première adresse en quelques minutes

Commencez avec le forfait gratuit et ses 100 boîtes aux lettres par mois. Aucune carte bancaire requise.

Commencer gratuitement Lire la documentation de l’API

API de temp mail pour les tests et l’automatisation

Payez par boîte aux lettres, pas par requête

De la clé API à la boîte de réception en quatre étapes

Créer une clé API

Créer une adresse

Lire les messages

La conserver ou la supprimer

Conçu pour des workflows e-mail répétables

Inscription et tests OTP

Pipelines CI/CD

QA et préproduction

Adresses sur votre propre domaine

Offres et tarifs

Gratuit

Starter

Pro

Business

Scale

Enterprise

Comparez les forfaits

Inclus dans chaque forfait

SDK officiels et CLI

Python

Node.js

PHP

Serveur MCP pour les agents IA

Serveur hébergé

Serveur local

FAQ sur l’API de messagerie temporaire

Créez votre première adresse en quelques minutes