Tmailor Open API

Tijdelijke mail-API voor testen en automatisering

Maak vanuit je code tijdelijke e-mailadressen aan die alleen kunnen ontvangen, en lees inkomende berichten als JSON. Elk adres blijft in je Tmailor-account staan tot je het verwijdert, en de API geeft de eenmalige code terug die het in een bericht vindt.

Laatst bijgewerkt: October 2026

Gratis beginnen Lees de API-documentatie

Bekijk plannen en limieten

REST en JSON
SDK's, CLI en MCP-server
100 gratis mailboxen per maand
Alleen ontvangen, berichten 24 uur bewaard

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;

Maak een adres aan, wacht op de e-mail, lees de code.

Betaal per mailbox, niet per verzoek

Alleen het aanmaken van een adres gebruikt je mailboxquota. Adressen opvragen, de inbox controleren en berichten lezen of verwijderen niet. Betaalde abonnementen hebben geen dagelijkse of maandelijkse limiet op verzoeken, alleen een limiet per minuut.

Voorbeeld: een OTP-test die één adres aanmaakt en de inbox 25 keer controleert, gebruikt één mailbox.

Van API-sleutel naar inbox in vier stappen

Maak een API-sleutel aan
Log in op het API-platform met je tmailor.com-account of met Google en maak een API-sleutel aan. Voeg bij het gratis abonnement ook het ene server-IP-adres toe dat de API mag aanroepen.
Maak een adres aan
Stuur één verzoek om een willekeurig adres te krijgen op een gedeeld domein, of kies een aangepaste naam op een domein dat je bezit en hebt geverifieerd.
Lees de berichten
Toon de inbox en lees elk bericht als JSON: afzender, onderwerp, tekst, opgeschoonde HTML, en de eenmalige code en links die de API heeft gevonden.
Bewaar het of verwijder het
Adressen verlopen niet. Open dezelfde inbox op tmailor.com met de hergebruiklink, of verwijder het adres als je test klaar is.

Gebouwd voor herhaalbare e-mailworkflows

Geef elke testrun een eigen inbox in plaats van één echte mailbox te delen.

Registratie- en OTP-tests

Maak een nieuw adres aan voor elke registratie, wachtwoordreset of eenmalige codecontrole en lees de code vervolgens uit het antwoord.

CI/CD-pipelines

Voer end-to-end e-mailcontroles uit in je pipeline met de sleutel in een omgevingsvariabele. Betaalde abonnementen accepteren verzoeken van elk IP-adres.

QA en staging

Geef testers en stagingomgevingen hun eigen adressen en houd echte inboxen buiten testdata.

Adressen op je eigen domein

Voeg een domein toe dat je bezit toe, wijs het MX-record naar ons en maak adressen met aangepaste namen die voldoen aan de naamgevingsregels.

Abonnementen en prijzen

Kies het aantal mailboxen dat je nodig hebt. Je tegoed wordt elke 30 dagen vernieuwd, ook bij jaarabonnementen.

Gratis

Probeer de API en start kleine projecten.

$0 /maand

100 mailboxen per 30 dagen
Tot 30 verzoeken per minuut
2,000 verzoeken per dag
Aanroepen vanaf één IP op de allowlist
Gedeelde domeinen en je eigen domeinen

Gratis beginnen

Starter

Voor één ontwikkelaar of een kleine testsuite.

$9 /maand

3,000 mailboxen per 30 dagen
Tot 300 verzoeken per minuut
Geen dagelijks of maandelijks verzoekquota
Aanroepen vanaf elk IP-adres
Gedeelde domeinen en je eigen domeinen

Kies Starter

Pro

Voor teams die dagelijks tests uitvoeren.

$29 /maand

30,000 mailboxen per 30 dagen
Tot 600 verzoeken per minuut
Geen dagelijks of maandelijks verzoekquota
Aanroepen vanaf elk IP-adres
Gedeelde domeinen en je eigen domeinen

Kies Pro

Business

Voor bedrijven met zware dagelijkse automatisering.

$99 /maand

150,000 mailboxen per 30 dagen
Tot 2,000 verzoeken per minuut
Geen dagelijks of maandelijks verzoekquota
Aanroepen vanaf elk IP-adres
Gedeelde domeinen en je eigen domeinen

Kies Business

Scale

Voor grote testparken en drukke pipelines.

$199 /maand

400,000 mailboxen per 30 dagen
Tot 4,000 verzoeken per minuut
Geen dagelijks of maandelijks verzoekquota
Aanroepen vanaf elk IP-adres
Gedeelde domeinen en je eigen domeinen

Kies Scale

Enterprise

Voor het hoogste mailboxvolume en de hoogste verzoekfrequentie.

$499 /maand

2,000,000 mailboxen per 30 dagen
Tot 6,000 verzoeken per minuut
Geen dagelijks of maandelijks verzoekquota
Aanroepen vanaf elk IP-adres
Gedeelde domeinen en je eigen domeinen

Kies Enterprise

Plannen vergelijken

Deze limieten verschillen per plan. Al het andere is op elk plan hetzelfde.

Plannen vergelijken
Plan	Gratis	Starter	Pro	Business	Scale	Enterprise
Maandelijkse prijs	$0	$9	$29	$99	$199	$499
Jaarlijkse prijs	$0	$90	$290	$990	$1,990	$4,990
Mailboxen per 30 dagen	100	3,000	30,000	150,000	400,000	2,000,000
Verzoeken per minuut	30	300	600	2,000	4,000	6,000
Dagelijkse verzoeklimiet	2,000	Geen limiet	Geen limiet	Geen limiet	Geen limiet	Geen limiet
IP-allowlist	Vereist, 1 IP	Niet nodig	Niet nodig	Niet nodig	Niet nodig	Niet nodig
Gehoste MCP-server	Alleen lokale server	Inbegrepen	Inbegrepen	Inbegrepen	Inbegrepen	Inbegrepen

Veeg zijwaarts om alle plannen te vergelijken.

Inbegrepen in elk plan

REST API met JSON-antwoorden
Willekeurige adressen op gedeelde domeinen
Aangepaste namen op je eigen geverifieerde domeinen
Onbeperkt eigen domeinen (maximaal 3 kunnen tegelijk op verificatie wachten)
Adressen die niet verlopen
Geen limiet op het aantal adressen dat je bewaart
Berichten worden 24 uur bewaard
Eenmalige codes en links extraheren (best effort)
Een hergebruiklink om de inbox op tmailor.com te openen
Officiële SDK's en een opdrachtregelprogramma
Plannen kunnen worden gecombineerd en hun limieten worden opgeteld
Alleen ontvangen, zonder bijlagen
Een adres verwijderen geeft geen quotum terug

Wanneer het aantal mailboxen is opgebruikt, kunnen er pas nieuwe adressen worden aangemaakt bij de volgende cyclus of na een upgrade. Bestaande inboxen blijven werken.
Betalingen zijn niet terugbetaalbaar volgens de API-voorwaarden. Test je integratie eerst op het gratis abonnement.

Officiële SDK's en CLI

Roep de API aan vanuit je eigen programmeertaal met getypeerde modellen, automatische herhalingen en een helper die wacht op het volgende bericht. Elke SDK volgt dezelfde API en dezelfde gedeelde testscenario's.

Python

Beschikbaar

Python 3.9+

pip install tmailor-sdk

Bevat de tmailor commandoregeltool.

Bekijk op PyPI Bron op GitHub

Node.js

Beschikbaar

Node.js 18+, TypeScript types

npm install tmailor

Bekijk op npm Bron op GitHub

PHP

Beschikbaar

PHP 8.1+

composer require tmailor/tmailor

Bekijk op Packagist Bron op GitHub

Voor AI-agenten

MCP-server voor AI-agenten

Laat Claude, Cursor, VS Code Copilot en andere MCP-clients aanmeldingsstromen testen die je bezit of waarvoor je toestemming hebt: de agent maakt een echt, alleen ontvangend adres aan, wacht op de e-mail en leest de eenmalige code of verificatielink.

Beide opties geven de agent dezelfde tools: een adres aanmaken, wachten op de e-mail en de eenmalige code en links ophalen, berichten lezen, adressen verwijderen en je quotum controleren. De agent ziet alleen e-mailadressen, nooit de tokens erachter, en gebruikt hetzelfde mailboxquotum en dezelfde ratelimit als de API.

Gehoste server

Niets te installeren

https://mcp.tmailor.com/mcp

Voeg de server-URL toe aan je AI-app. Apps die aanmelden ondersteunen, zoals Claude, ChatGPT en Codex, sturen je naar het Tmailor-platform om toegang goed te keuren. Andere clients sturen je API-sleutel mee in de Authorization-header.

Vereist een actief betaald abonnement. Oproepen komen van onze server, dus je hebt geen IP-allowlist nodig.

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

Bekijk verbonden apps op de pagina AI-verbindingen en koppel ze indien nodig los. Een losgekoppelde app verliest binnen 30 seconden de toegang.

Bekijk plannen en limieten

Lokale server

Elk abonnement, ook gratis

tmailor-mcp

Het draait op je computer, leest je sleutel uit TMAILOR_API_KEY en vereist uv of Python 3.10+. Op het gratis abonnement moet je het IP-adres van die computer op de allowlist zetten.

# 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

Bekijk op PyPI Installatie voor elke MCP-client

Probeer te vragen: "Maak een tijdelijke e-mail aan, meld je daarmee aan op mijn staging-site en geef me de verificatiecode."

FAQ over de tijdelijke mail-API

Wat telt als één mailbox?

Elk nieuw adres dat je aanmaakt, gebruikt één mailbox uit de limiet van de huidige cyclus van 30 dagen. Oplijsten, lezen en verwijderen gebruiken geen mailboxen, en een adres verwijderen geeft de mailbox niet terug.

Verlopen de adressen?

Nee. Een adres blijft in je account tot je het verwijdert. Berichten erin worden 24 uur bewaard.

Kan ik e-mail versturen of bijlagen ontvangen?

Nee. De API is alleen voor ontvangen en bijlagen worden niet afgeleverd.

Kan ik de adresnaam en het domein kiezen?

Op onze gedeelde domeinen is de naam willekeurig. Om de naam te kiezen, voeg je een eigen domein toe op het API-platform en verifieer je het door het MX-record naar ons te wijzen; daarna maak je adressen aan met een eigen naam die voldoet aan de naamgevingsregels.

Heb ik een IP-allowlist nodig?

Alleen bij het gratis abonnement, waarbij je het ene IP-adres toevoegt waarvandaan je server verzoeken doet. Een IP-adres kan bij slechts één gratis account horen, dus een gedeeld kantoor- of VPN-adres is mogelijk al in gebruik. Met een actief betaald abonnement accepteert de API verzoeken vanaf elk IP-adres.

Leest de API de verificatiecode voor mij?

Ja, op best-effortbasis. Wanneer je een bericht leest, bevat het antwoord de eenmalige code die is gevonden (of null als het niet zeker is), andere code-achtige waarden en de links. Controleer de waarde altijd in je test.

Kunnen AI-agenten zoals Claude of ChatGPT de API gebruiken?

Ja, via MCP. Met een betaald abonnement voeg je de gehoste server https://mcp.tmailor.com/mcp toe aan je AI-app en keur je de toegang goed, of je stuurt je API-sleutel mee. Op elk abonnement kun je de open-source tmailor-mcp-server op je eigen computer draaien. In beide gevallen kan de agent een adres aanmaken, wachten op de e-mail en de eenmalige code lezen, met hetzelfde mailboxquota als de API.

Is er een verzoeklimiet op betaalde abonnementen?

Betaalde abonnementen hebben geen dagelijkse of maandelijkse verzoekquota, maar elk abonnement heeft een limiet per minuut. Het gratis abonnement heeft ook een dagelijkse verzoeklimiet.

Heb ik een creditcard nodig om te beginnen?

Nee. Log in met je tmailor.com-account of met Google, maak een sleutel aan en begin met het gratis abonnement. Je betaalt pas wanneer je een betaald abonnement kiest.

Hoe kan ik een abonnement betalen?

Betaal met USDT op het TRC20- (Tron) of BEP20-netwerk (BNB Smart Chain), of met Binance Pay. Creditcards en betaalkaarten worden niet geaccepteerd. Je abonnement wordt actief zodra de betaling is bevestigd, meestal binnen een paar minuten.

Kan ik een terugbetaling krijgen?

Nee. Betalingen zijn niet terugbetaalbaar, dus test je integratie op het gratis abonnement voordat je upgradet.

Waarvoor mag de API niet worden gebruikt?

Spam, fraude, het in bulk aanmaken van accounts op andere diensten en het omzeilen van hun bans of limieten schenden de API-voorwaarden. We kunnen de API-sleutels van accounts die dit doen intrekken en de accounts vergrendelen.

Maak binnen enkele minuten je eerste adres aan

Begin met het gratis abonnement met 100 mailboxen per maand. Geen creditcard nodig.

Gratis beginnen Lees de API-documentatie

Tijdelijke mail-API voor testen en automatisering

Betaal per mailbox, niet per verzoek

Van API-sleutel naar inbox in vier stappen

Maak een API-sleutel aan

Maak een adres aan

Lees de berichten

Bewaar het of verwijder het

Gebouwd voor herhaalbare e-mailworkflows

Registratie- en OTP-tests

CI/CD-pipelines

QA en staging

Adressen op je eigen domein

Abonnementen en prijzen

Gratis

Starter

Pro

Business

Scale

Enterprise

Plannen vergelijken

Inbegrepen in elk plan

Officiële SDK's en CLI

Python

Node.js

PHP

MCP-server voor AI-agenten

Gehoste server

Lokale server

FAQ over de tijdelijke mail-API

Maak binnen enkele minuten je eerste adres aan