API für Entwickler

Wegwerf-Mailboxes per curl.

Erzeuge programmatisch Mailboxes, pull Inboxes per REST oder lass dir Mails via Webhook pushen. Made for CI, QA-Suites und Anti-Bot-Workflows.

~/mailiy/quickstart

60 Sekunden Einstieg

01$ curl -X POST https://api.mailiy.com/v1/mailbox \
02    -H 'Authorization: Bearer mly_***********' \
03    -d '{ "ttl": 1800 }'
04 
05→ 201 Created
06{ "address": "f4r1y2@mailiy.com",
07  "expires_at": "2026-05-13T18:42:00Z" }

Die Mailiy-REST-API erzeugt und verwaltet Wegwerf-Mail-Postfächer programmatisch — gedacht für Playwright- und Cypress-Tests, CI-Pipelines, Anti-Bot-Workflows und alles, was Mailboxen zur Laufzeit braucht. Authentifizierung läuft per Bearer-Token im Authorization-Header. API-Keys generierst du in den Account-Einstellungen, sie beginnen mit ml_pk_ und können jederzeit rotiert werden.

Der typische Flow ist drei Calls: POST /v1/mailbox erzeugt eine frische Adresse (optional mit ttlMinutes), GET /v1/mailbox/:id/messages pollt eingehende Mails, DELETE /v1/mailbox/:id räumt am Ende auf. Wer lieber synchron arbeitet, registriert mit POST /v1/webhooks einen Push auf eine eigene URL und bekommt eingehende Mails als JSON-Event geliefert. Rate-Limits sind pro Tarif kalkulierbar — der Free-Tarif liefert 500 Calls pro Monat bei 10 req/min, ausreichend für eine kleine CI-Suite.

Jährlich = 2 Monate gratis

./tier_01

Free

0 €/mo

calls500 / Monat

rate10 req/min

supportCommunity

webhooks—

analytics—

custom—

./tier_02

Lite

9 €/mo

calls10.000

rate60 req/min

supportE-Mail (72 h)

webhooks✓

analytics—

custom—

recommended

./tier_03

Pro

29 €/mo

calls100.000

rate300 req/min

supportE-Mail (24 h)

webhooks✓

analytics✓

custom—

./tier_04

Business

99 €/mo

calls500.000

rate1.000 req/min

supportSlack-Channel

webhooks✓

analytics✓

custom—

./tier_05

Enterprise

Auf Anfrage

calls1 Mio+ / Custom

rateUnlimitiert

supportSLA & TAM

webhooks✓

analytics✓

custom✓

REST Endpoints

v1 · stable

POST/v1/mailboxCreate a mailbox with optional TTL.free+

GET/v1/mailbox/:idFetch mailbox metadata.free+

GET/v1/mailbox/:id/messagesList messages in inbox.free+

GET/v1/messages/:idFetch a full message with attachments.free+

DELETE/v1/mailbox/:idDrop the mailbox immediately.free+

POST/v1/webhooksSubscribe to inbound mail events.lite+

Wir liefern kein offizielles SDK, weil die API klein genug ist, dass curl, fetch oder ein beliebiger HTTP-Client reichen. Beispiele in TypeScript für Playwright und Cypress findest du in den Blog-Posts; PHP-, Python- und Go-Clients sind Community-Beiträge. Alle Endpunkte sind v1 stable — Breaking Changes kündigen wir mindestens 90 Tage vorher per E-Mail an alle aktiven API-Key-Inhaber an.

Wenn dein Use-Case mehr braucht als die Pro-Tarife abdecken (mehr als 100.000 Calls/Monat, mehr als 300 req/min, garantiertes SLA, eigener Slack-Support-Kanal), schreib uns an sales@mailiy.com. Wir haben Business- und Enterprise-Stufen mit dediziertem TAM und Custom-Domain-Pools, aber die machen erst bei sinnvollem Volumen Sinn — bei kleineren Volumen ist Pro praktisch immer das richtige Werkzeug.