Tmailor Open API

Temp Mail API für Tests und Automatisierung

Erstelle aus deinem Code temporäre E-Mail-Adressen, die nur empfangen können, und lies eingehende Nachrichten als JSON aus. Jede Adresse bleibt in deinem Tmailor-Konto, bis du sie löschst, und die API gibt den Einmalcode zurück, den sie in einer Nachricht findet.

Zuletzt aktualisiert: October 2026

Kostenlos starten API-Dokumentation lesen

Pläne und Limits ansehen

REST und JSON
SDKs, CLI und MCP-Server
100 kostenlose Postfächer pro Monat
Nur Empfang, Nachrichten 24 Stunden verfügbar

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;

Erstelle eine Adresse, warte auf die E-Mail, lies den Code.

Zahl pro Mailbox, nicht pro Anfrage

Nur das Erstellen einer Adresse verbraucht dein Mailbox-Kontingent. Adressen auflisten, den Posteingang prüfen und Nachrichten lesen oder löschen nicht. Kostenpflichtige Tarife haben kein tägliches oder monatliches Anfragekontingent, nur ein Ratenlimit pro Minute.

Beispiel: Ein OTP-Test, der eine Adresse erstellt und den Posteingang 25 Mal prüft, verbraucht eine Mailbox.

Vom API-Schlüssel zum Posteingang in vier Schritten

API-Schlüssel erstellen
Melde dich mit deinem tmailor.com-Konto oder mit Google bei der API-Plattform an und erstelle einen Schlüssel. Im kostenlosen Tarif musst du außerdem die eine Server-IP-Adresse hinzufügen, die die API aufrufen wird.
Adresse erstellen
Senden Sie eine Anfrage, um eine zufällige Adresse auf einer gemeinsamen Domain zu erhalten, oder wählen Sie einen eigenen Namen auf einer Domain, die Sie besitzen und verifiziert haben.
Nachrichten lesen
Rufen Sie den Posteingang ab und lesen Sie jede Nachricht als JSON: Absender, Betreff, Text, bereinigtes HTML sowie den Einmalcode und die Links, die die API gefunden hat.
Behalten oder löschen
Adressen verfallen nicht. Öffnen Sie denselben Posteingang auf tmailor.com über den Wiederverwendungslink oder löschen Sie die Adresse, wenn Ihr Test abgeschlossen ist.

Entwickelt für wiederholbare E-Mail-Workflows

Gib jedem Testlauf einen eigenen Posteingang, statt ein echtes Postfach gemeinsam zu nutzen.

Anmelde- und OTP-Tests

Erstelle für jede Anmeldung, jeden Passwort-Reset oder jede OTP-Prüfung eine neue Adresse und lies den Code dann aus der Antwort aus.

CI/CD-Pipelines

Führe End-to-End-E-Mail-Prüfungen in deiner Pipeline aus und lies den Schlüssel aus einer Umgebungsvariable. Kostenpflichtige Tarife akzeptieren Anfragen von jeder IP-Adresse.

QA und Staging

Gib Testern und Staging-Umgebungen eigene Adressen und halte echte Postfächer aus Testdaten heraus.

Adressen auf Ihrer eigenen Domain

Füge eine Domain, die du besitzt hinzu, richte den MX-Eintrag auf uns aus und erstelle Adressen mit benutzerdefinierten Namen, die den Namensregeln folgen.

Pläne und Preise

Wählen Sie die Anzahl der benötigten Postfächer. Ihr Kontingent wird alle 30 Tage zurückgesetzt, auch bei Jahresplänen.

Kostenlos

Teste die API und starte kleine Projekte.

$0 /Monat

100 Postfächer alle 30 Tage
Bis zu 30 Anfragen pro Minute
2,000 Anfragen pro Tag
Aufrufe von einer freigegebenen IP
Gemeinsame Domains und eigene Domains

Kostenlos starten

Starter

Für einen Entwickler oder eine kleine Testsuite.

$9 /Monat

3,000 Postfächer alle 30 Tage
Bis zu 300 Anfragen pro Minute
Kein Tages- oder Monatslimit für Anfragen
Aufrufe von jeder IP-Adresse
Gemeinsame Domains und eigene Domains

Starter wählen

Pro

Für Teams, die täglich Tests ausführen.

$29 /Monat

30,000 Postfächer alle 30 Tage
Bis zu 600 Anfragen pro Minute
Kein Tages- oder Monatslimit für Anfragen
Aufrufe von jeder IP-Adresse
Gemeinsame Domains und eigene Domains

Pro wählen

Business

Für Unternehmen mit umfangreicher täglicher Automatisierung.

$99 /Monat

150,000 Postfächer alle 30 Tage
Bis zu 2,000 Anfragen pro Minute
Kein Tages- oder Monatslimit für Anfragen
Aufrufe von jeder IP-Adresse
Gemeinsame Domains und eigene Domains

Business wählen

Scale

Für große Testflotten und stark ausgelastete Pipelines.

$199 /Monat

400,000 Postfächer alle 30 Tage
Bis zu 4,000 Anfragen pro Minute
Kein Tages- oder Monatslimit für Anfragen
Aufrufe von jeder IP-Adresse
Gemeinsame Domains und eigene Domains

Scale wählen

Enterprise

Für das höchste Postfachvolumen und die höchste Anfragenrate.

$499 /Monat

2,000,000 Postfächer alle 30 Tage
Bis zu 6,000 Anfragen pro Minute
Kein Tages- oder Monatslimit für Anfragen
Aufrufe von jeder IP-Adresse
Gemeinsame Domains und eigene Domains

Enterprise wählen

Tarife vergleichen

Diese Limits unterscheiden sich je nach Tarif. Alles andere ist bei jedem Tarif gleich.

Tarife vergleichen
Tarif	Kostenlos	Starter	Pro	Business	Scale	Enterprise
Monatlicher Preis	$0	$9	$29	$99	$199	$499
Jahrespreis	$0	$90	$290	$990	$1,990	$4,990
Postfächer alle 30 Tage	100	3,000	30,000	150,000	400,000	2,000,000
Anfragen pro Minute	30	300	600	2,000	4,000	6,000
Tägliches Anfragelimit	2,000	Kein Limit	Kein Limit	Kein Limit	Kein Limit	Kein Limit
IP-Allowlist	Erforderlich, 1 IP	Nicht nötig	Nicht nötig	Nicht nötig	Nicht nötig	Nicht nötig
Gehosteter MCP-Server	Nur lokaler Server	Enthalten	Enthalten	Enthalten	Enthalten	Enthalten

Wische seitlich, um alle Tarife zu vergleichen.

In jedem Tarif enthalten

REST-API mit JSON-Antworten
Zufällige Adressen auf gemeinsam genutzten Domains
Eigene Namen auf deinen verifizierten Domains
Unbegrenzt eigene Domains (bis zu 3 können gleichzeitig auf die Verifizierung warten)
Adressen, die nicht ablaufen
Keine Begrenzung der Anzahl an Adressen, die du behältst
Nachrichten werden 24 Stunden lang aufbewahrt
Extraktion von Einmalcodes und Links (Best Effort)
Ein Wiederverwendungslink, um den Posteingang auf tmailor.com zu öffnen
Offizielle SDKs und ein Kommandozeilen-Tool
Tarife lassen sich kombinieren, ihre Limits addieren sich
Nur Empfang, ohne Anhänge
Das Löschen einer Adresse gibt kein Kontingent zurück

Wenn das Mailbox-Kontingent aufgebraucht ist, können erst im nächsten Zyklus oder nach einem Upgrade neue Adressen erstellt werden. Bestehende Postfächer funktionieren weiterhin.
Zahlungen sind gemäß den API-Bedingungen nicht erstattungsfähig. Testen Sie Ihre Integration zuerst im kostenlosen Tarif.

Offizielle SDKs und CLI

Rufen Sie die API aus Ihrer Programmiersprache mit typisierten Modellen, automatischen Wiederholungsversuchen und einem Helfer auf, der auf die nächste Nachricht wartet. Jedes SDK nutzt dieselbe API und dieselben gemeinsamen Testszenarien.

Python

Verfügbar

Python 3.9+

pip install tmailor-sdk

Enthält das tmailor-Befehlszeilenwerkzeug.

Auf PyPI ansehen Quellcode auf GitHub

Node.js

Verfügbar

Node.js 18+, TypeScript types

npm install tmailor

Auf npm ansehen Quellcode auf GitHub

PHP

Verfügbar

PHP 8.1+

composer require tmailor/tmailor

Auf Packagist ansehen Quellcode auf GitHub

Für KI-Agenten

MCP-Server für KI-Agenten

Lass Claude, Cursor, VS Code Copilot und andere MCP-Clients Anmeldeabläufe testen, die dir gehören oder die du testen darfst: Der Agent erstellt eine echte Adresse, die nur empfangen kann, wartet auf die E-Mail und liest den Einmalcode oder den Verifizierungslink.

Beide Optionen geben dem Agenten dieselben Werkzeuge: eine Adresse erstellen, auf die E-Mail warten und ihren Einmalcode und ihre Links abrufen, Nachrichten lesen, Adressen löschen und dein Kontingent prüfen. Der Agent sieht nur E-Mail-Adressen, nie die dahinterstehenden Token, und er nutzt dasselbe Postfach-Kontingent und Rate-Limit wie die API.

Gehosteter Server

Nichts zu installieren

https://mcp.tmailor.com/mcp

Füge die Server-URL in deine KI-App ein. Apps mit Anmeldeunterstützung wie Claude, ChatGPT und Codex leiten dich zur Tmailor-Plattform weiter, um den Zugriff zu genehmigen. Andere Clients senden deinen API-Schlüssel im Authorization-Header.

Erfordert einen aktiven kostenpflichtigen Plan. Die Anfragen kommen von unserem Server, daher brauchst du keine IP-Allowlist.

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

Siehe verbundene Apps auf der AI-Verbindung-Seite und trenne jede davon. Eine getrennte App verliert innerhalb von 30 Sekunden den Zugriff.

Pläne und Limits ansehen

Lokaler Server

Alle Tarife, auch der kostenlose

tmailor-mcp

Es läuft auf deinem Computer, liest deinen Schlüssel aus TMAILOR_API_KEY und benötigt uv oder Python 3.10+. Im kostenlosen Tarif musst du die IP-Adresse dieses Computers auf die Allowlist setzen.

# 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

Auf PyPI ansehen Einrichtung für jeden MCP-Client

Frag zum Beispiel: „Erstelle eine temporäre E-Mail, melde dich damit auf meiner Staging-Seite an und nenne mir den Verifizierungscode.“

FAQ zur Temp-Mail-API

Was zählt als Postfach?

Jede neue Adresse, die Sie erstellen, verbraucht ein Postfach aus dem Kontingent des aktuellen 30-Tage-Zyklus. Auflisten, Lesen und Löschen verbrauchen keine Postfächer, und das Löschen einer Adresse gibt das Postfach nicht zurück.

Laufen die Adressen ab?

Nein. Eine Adresse bleibt in Ihrem Konto, bis Sie sie löschen. Nachrichten darin werden 24 Stunden lang aufbewahrt.

Kann ich E-Mails senden oder Anhänge empfangen?

Nein. Die API ist nur zum Empfang gedacht, und Anhänge werden nicht zugestellt.

Kann ich den Adressnamen und die Domain wählen?

Auf unseren gemeinsamen Domains ist der Name zufällig. Um den Namen zu wählen, fügen Sie eine eigene Domain auf der API-Plattform hinzu und verifizieren Sie sie, indem Sie ihren MX-Eintrag auf uns zeigen lassen, und erstellen Sie dann Adressen mit einem benutzerdefinierten Namen, der den Namensregeln entspricht.

Brauche ich eine IP-Allowlist?

Nur im kostenlosen Tarif, wo du die eine IP-Adresse hinzufügst, von der aus dein Server Anfragen sendet. Eine IP-Adresse kann nur zu einem kostenlosen Konto gehören, daher kann eine gemeinsame Büro- oder VPN-Adresse bereits vergeben sein. Bei einem aktiven kostenpflichtigen Tarif akzeptiert die API Anfragen von jeder IP-Adresse.

Liest die API den Verifizierungscode für mich?

Ja, nach bestem Bemühen. Wenn Sie eine Nachricht lesen, enthält die Antwort den gefundenen Einmalcode (oder null, wenn sie sich nicht sicher ist), weitere codeähnliche Werte und die Links. Prüfen Sie den Wert in Ihrem Test immer selbst.

Können KI-Agenten wie Claude oder ChatGPT die API nutzen?

Ja, über MCP. In einem kostenpflichtigen Tarif fügen Sie den gehosteten Server https://mcp.tmailor.com/mcp Ihrer KI-App hinzu und genehmigen den Zugriff oder senden Ihren API-Schlüssel. In jedem Tarif können Sie den Open-Source-Server tmailor-mcp auf Ihrem eigenen Computer betreiben. In beiden Fällen kann der Agent eine Adresse erstellen, auf die E-Mail warten und den Einmalcode lesen, wobei er dasselbe Postfachkontingent wie die API nutzt.

Gibt es ein Anfragelimit bei kostenpflichtigen Tarifen?

Kostenpflichtige Tarife haben kein tägliches oder monatliches Anfragekontingent, aber jeder Tarif hat ein Ratenlimit pro Minute. Der Free-Tarif hat zusätzlich eine tägliche Anfrageobergrenze.

Brauche ich eine Kreditkarte, um zu starten?

Nein. Melde dich mit deinem tmailor.com-Konto oder mit Google an, erstelle einen Schlüssel und starte mit dem kostenlosen Tarif. Du zahlst nur, wenn du einen kostenpflichtigen Tarif wählst.

Wie kann ich einen Tarif bezahlen?

Bezahle mit USDT im TRC20-Netzwerk (Tron) oder BEP20-Netzwerk (BNB Smart Chain) oder mit Binance Pay. Kredit- und Debitkarten werden nicht akzeptiert. Dein Tarif wird aktiv, sobald die Zahlung bestätigt ist, in der Regel innerhalb weniger Minuten.

Kann ich eine Rückerstattung erhalten?

Nein. Zahlungen sind nicht erstattungsfähig. Testen Sie Ihre Integration daher im Free-Tarif, bevor Sie upgraden.

Wofür darf die API nicht verwendet werden?

Spam, Betrug, das massenhafte Erstellen von Konten auf anderen Diensten und das Umgehen von deren Sperren oder Limits verstoßen gegen die API-Bedingungen. Wir können die API-Schlüssel von Konten, die dies tun, widerrufen und die Konten sperren.

Erstellen Sie Ihre erste Adresse in wenigen Minuten

Starten Sie mit dem kostenlosen Tarif mit 100 Postfächern pro Monat. Keine Kreditkarte erforderlich.

Kostenlos starten API-Dokumentation lesen

Temp Mail API für Tests und Automatisierung

Zahl pro Mailbox, nicht pro Anfrage

Vom API-Schlüssel zum Posteingang in vier Schritten

API-Schlüssel erstellen

Adresse erstellen

Nachrichten lesen

Behalten oder löschen

Entwickelt für wiederholbare E-Mail-Workflows

Anmelde- und OTP-Tests

CI/CD-Pipelines

QA und Staging

Adressen auf Ihrer eigenen Domain

Pläne und Preise

Kostenlos

Starter

Pro

Business

Scale

Enterprise

Tarife vergleichen

In jedem Tarif enthalten

Offizielle SDKs und CLI

Python

Node.js

PHP

MCP-Server für KI-Agenten

Gehosteter Server

Lokaler Server

FAQ zur Temp-Mail-API

Erstellen Sie Ihre erste Adresse in wenigen Minuten