Migrationsleitfaden
Von Mailgun zu Mail.Land migrieren
Wenn Sie per SMTP senden, ändern Sie nur Host und Passwort. Wenn Sie die Messages-API nutzen, ordnet dieser Leitfaden jedes gängige Mailgun-Feld Mail.Land zu und nennt, was eine Codeänderung erfordert.
# Before (Mailgun)
SMTP_HOST=smtp.mailgun.org
SMTP_PORT=587 # STARTTLS
SMTP_USER=<SMTP login of your sending domain>
SMTP_PASS=<SMTP password of that login>
# After (Mail.Land)
SMTP_HOST=smtp.mail.land
SMTP_PORT=587 # STARTTLS
SMTP_USER=apikey # any value; Mail.Land ignores it
SMTP_PASS=ml_pet_... # a Mail.Land key with SMTP enabledMailgun-Konzepte in Mail.Land
| Mailgun | Mail.Land |
|---|---|
| Absender-Domain | Verifizierte Domain (SPF, DKIM, DMARC und Return-Path) |
| API-Schlüssel und Domain-Sendeschlüssel | API-Schlüssel (Zugangsdaten), jeweils auf API oder SMTP, auf Domains und auf IP-Adressen beschränkbar |
| SMTP-Zugangsdaten pro Domain | Derselbe API-Schlüssel, als SMTP-Passwort verwendet |
| Vorlagen (Handlebars) | Vorlagen mit {{name}}-Platzhaltern |
| Listen für Bounces, Beschwerden und Abmeldungen | Sperrlisten mit Typ und Geltungsbereich |
| Webhooks | Mit HMAC-SHA256 signierte Webhooks, ein Geheimnis pro Webhook |
| Routes | Eingangsrouten |
Die passenden API-Schlüssel anlegen
Das Präfix eines Mail.Land-Schlüssels zeigt Modus und Stream. Legen Sie pro Anwendung und Stream einen Schlüssel an und halten Sie Produktionsschlüssel aus Ihren Testsystemen heraus.
| Präfix | Wofür er gedacht ist |
|---|---|
ml_pet_ | Produktion, Transaktion: Belege, Passwort-Zurücksetzungen, Benachrichtigungen. Bis zu 5 Empfänger pro Anfrage. |
ml_pem_ | Produktion, Marketing: Newsletter und Massenversand mit send-batch, bis zu 10.000 Empfänger pro Aufruf. |
ml_set_ | Sandbox, Transaktion: Mit sandboxBehavior LogOnly (Standard) werden Anfragen angenommen und protokolliert, aber nie zugestellt. Nutzen Sie ihn für Ihre Integrationstests. |
Jeder Schlüssel lässt sich auf API, SMTP oder beides, auf ausgewählte Domains und auf bekannte IP-Adressen beschränken. Ein Schlüssel wird einmal angezeigt; Mail.Land speichert nur einen Hash davon.
SMTP umstellen: Host und Passwort ändern
Mailgun verwendet ein SMTP-Login pro Absender-Domain. Mail.Land verwendet Ihren API-Schlüssel als Passwort und ignoriert den Benutzernamen.
| Einstellung | Mailgun | Mail.Land |
|---|---|---|
| Host | smtp.mailgun.org | smtp.mail.land |
| Port | 25, 587 oder 2525 mit STARTTLS oder 465 mit TLS | 587 mit STARTTLS |
| Benutzername | Das SMTP-Login Ihrer Absender-Domain | Beliebiger Wert, zum Beispiel apikey |
| Passwort | Das Passwort dieses SMTP-Logins | Ein Mail.Land-API-Schlüssel mit aktiviertem SMTP (ml_pet_ für Transaktions-E-Mails) |
Mail.Land akzeptiert die Anmeldung nur nach STARTTLS, Port 465 wird nicht angeboten. Wenn Ihre Anwendung 465 nutzt, stellen Sie auf 587 mit STARTTLS um. Nachrichten dürfen bis zu 15 MiB groß sein.
Den API-Aufruf umstellen
Mailgun erwartet Formularfelder mit HTTP-Basic-Authentifizierung. Mail.Land erwartet einen JSON-Body mit dem Header X-API-Key. Hier sehen Sie dieselbe Nachricht in beiden APIs sowie einen Batch-Versand.
curl -s --user "api:$MAILGUN_API_KEY" \
https://api.mailgun.net/v3/yourdomain.com/messages \
-F from="Your Shop <[email protected]>" \
-F to="Jane <[email protected]>" \
-F subject="Order 12345 has shipped" \
-F text="Your order is on its way." \
-F html="<p>Your order is on its way.</p>" \
-F h:Reply-To="[email protected]" \
-F o:tag="order-shipped"curl -X POST https://api.mail.land/v1/transactional/send \
-H "X-API-Key: $MAILLAND_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"from": { "email": "[email protected]", "name": "Your Shop" },
"to": [{
"email": "[email protected]", "name": "Jane",
"variables": { "orderNumber": "12345" }
}],
"replyTo": "[email protected]",
"subject": "Order {{orderNumber}} has shipped",
"textContent": "Your order {{orderNumber}} is on its way.",
"htmlContent": "<p>Your order {{orderNumber}} is on its way.</p>",
"tags": ["order-shipped"]
}'
# MAILLAND_API_KEY=ml_pet_... (production, transactional)Feldzuordnung für den Sendeaufruf
Von POST /v3/<domain>/messages zu POST /v1/transactional/send.
| Mailgun | Mail.Land | Hinweis |
|---|---|---|
--user api:<key> (Basic-Authentifizierung) | X-API-Key: <key> | Ein Header statt Basic-Authentifizierung und ein JSON-Body statt Formularfeldern. |
from | from.email, from.name | Trennen Sie den Anzeigenamen von der Adresse. Die Adresse muss zu einer verifizierten Domain gehören. |
to | to[].email, to[].name | Bis zu 5 Empfänger pro Anfrage mit einem Transaktionsschlüssel; jeder erhält eine eigene Kopie. |
cc, bcc | Keine | Nicht unterstützt. Senden Sie jedem Empfänger eine eigene Nachricht. |
subject | subject | Erforderlich, außer Sie verwenden eine Vorlage. |
text | textContent | |
html | htmlContent | |
amp-html | Keine | Es gibt keinen AMP-Teil. |
template, t:version | templateId | Legen Sie die Vorlage zuerst in Mail.Land neu an. Vorlagen haben keine Versionen. |
t:variables | variables | Werte für alle Empfänger, als JSON-Objekt statt als JSON-String. |
v:<name> (metadata) | tags | Mail.Land kennt keine Schlüssel-Wert-Metadaten an Ereignissen. Übertragen Sie eine Kennung in tags oder in einem eigenen Header. |
recipient-variables | to[].variables | Werte pro Empfänger. Für mehr als 5 Empfänger nutzen Sie send-batch mit einem Marketingschlüssel und recipients[].variables. |
o:tag | tags | Ein Array von Strings. |
h:<Header-Name> | customHeaders | Ein Objekt aus Headernamen und -werten. |
h:Reply-To | replyTo | Ein einfacher Adress-String. |
attachment, inline | attachments[].fileName, contentType, content, contentId, inline | Base64-Inhalt in JSON statt Multipart-Dateien. Bis zu 10 Anhänge und insgesamt 10 MiB. |
o:deliverytime | scheduledAt | Datum und Uhrzeit in UTC nach ISO 8601, bis zu 7 Tage im Voraus. |
o:tracking-opens, o:tracking-clicks | tracking.opens, tracking.clicks | Boolesche Werte. Die eigene Einstellung der Domain zum Öffnungs-Tracking hat Vorrang. |
Keine Entsprechung | Header X-Idempotency-Key | Innerhalb der Aufbewahrungsfrist liefert eine Wiederholung mit demselben Schlüssel die ursprüngliche Antwort, statt erneut zu senden. |
Mail.Land antwortet mit 202 Accepted, einer jobId, einer Nachrichten-ID pro angenommenem Empfänger sowie den Listen der angenommenen und abgelehnten Empfänger.
Domain und DNS-Einträge hinzufügen
Fügen Sie die Domain in Mail.Land hinzu und veröffentlichen Sie die Einträge, die das Dashboard anzeigt. SPF, DKIM und DMARC müssen verifiziert sein, bevor Sie senden können. Das geht, während Mailgun noch sendet.
| Eintrag | Name | Wert | Hinweis |
|---|---|---|---|
| SPF (TXT) | yourdomain.com | include:spf.mlnd.net | Fügen Sie das include zu Ihrem bestehenden SPF-Eintrag hinzu. Eine Domain darf nur einen SPF-Eintrag haben. |
| DKIM (TXT) | mlnd._domainkey.yourdomain.com | v=DKIM1; k=rsa; p=... | Der Selektor ist mlnd, daher steht der Eintrag neben dem DKIM-Eintrag von Mailgun. |
| DMARC (TXT) | _dmarc.yourdomain.com | v=DMARC1; p=... | Erforderlich. Behalten Sie einen einzigen DMARC-Eintrag; ein vorhandener mit Richtlinie genügt. |
| Return-Path (CNAME) | bounce.yourdomain.com | bounce.mlnd.net | Auf DNS only setzen, nicht über einen Proxy. Prüfen Sie, dass dieser Name noch nicht verwendet wird. |
Behalten Sie die DNS-Einträge von Mailgun bis zum Abschluss des Umzugs und entfernen Sie sie erst, wenn die letzte Nachricht verschickt ist.
Zuerst die Sperrlisten importieren
Mailgun führt Bounces, Beschwerden und Abmeldungen pro Absender-Domain. Exportieren Sie daher die Listen jeder Domain, von der Sie senden, zum Beispiel mit GET /v3/<domain>/bounces. Importieren Sie dann jede Liste mit passendem Typ und Geltungsbereich in Mail.Land, im Dashboard oder mit POST /v1/transactional/suppressions/import.
| Mailgun-Liste | Typ in Mail.Land | Geltungsbereich |
|---|---|---|
| Bounces | HardBounce | Global |
| Beschwerden (Complaints) | Complaint | Global |
| Abmeldungen (alle E-Mails) | Unsubscribe | Global |
| Abmeldungen für ein Tag oder eine Mailingliste | Unsubscribe | Marketing; oder List, das nur für Kampagnen an die passende Mail.Land-Mailingliste gilt |
Importieren Sie vor dem ersten Versand über Mail.Land, damit abgemeldete Personen von Anfang an gesperrt bleiben. Bereits vorhandene Adressen werden übersprungen, nicht doppelt angelegt.
Webhooks auf Mail.Land umstellen
Fügen Sie Ihren Endpunkt in Mail.Land hinzu, wählen Sie die Ereignisse und prüfen Sie den Header X-MLND-Signature. Mailgun signiert Zeitstempel und Token mit einem kontoweiten Schlüssel; Mail.Land signiert Zeitstempel und Roh-Body mit einem Geheimnis pro Webhook. Passen Sie daher auch Ihren Prüfcode an.
| Mailgun-Ereignis | Mail.Land-Ereignis | Hinweis |
|---|---|---|
accepted | Derzeit keine | message.sent ist noch nicht verfügbar; die Antwort 202 bestätigt die Annahme. |
delivered | message.delivered | |
temporary_fail | message.deferred | |
permanent_fail | message.bounced | Eine Ablehnung durch den empfangenden Server. message.failed meldet einen Abbruch auf Seiten von Mail.Land. |
complained | message.complained | |
unsubscribed | message.unsubscribed | Wird für die eigene Abmeldung des Empfängers gesendet, nicht für Änderungen, die Sie über die API vornehmen. |
opened, clicked | Noch nicht verfügbar | Öffnungs- und Klick-Ereignisse sind im Katalog aufgeführt, werden heute aber nicht gesendet. |
Deduplizieren Sie anhand von event_id, denn eine wiederholte Zustellung trägt dieselbe Ereignis-ID. Ein Status kann später korrigiert werden; verarbeiten Sie daher auch nach einem finalen Ereignis weiter und vergleichen Sie status_version.
Vorlagen neu anlegen
Legen Sie jede Vorlage im Mail.Land-Dashboard oder über die Vorlagen-API an und senden Sie sie mit templateId und variables. Jeder Platzhalter braucht einen Wert, sonst wird der Versand mit 422 und den fehlenden Namen abgelehnt.
| Mailgun | Mail.Land |
|---|---|
{{firstName}} | {{firstName}} |
%recipient.firstName% | {{firstName}} |
{{#if}}, {{#unless}}, {{#each}}, {{#with}}, {{#equal}} | Keine |
Vorlagenversionen (t:version) | Keine |
Mail.Land-Platzhalter sind schlicht: keine Bedingungen, Schleifen, Filter oder Partials. Verlagern Sie diese Logik in Ihre Anwendung oder führen Sie eine Vorlage pro Variante.
Schrittweise wechseln
- Fügen Sie Ihre Absender-Domain in Mail.Land hinzu und verifizieren Sie sie; ergänzen Sie include:spf.mlnd.net in Ihrem bestehenden SPF-Eintrag.
- Exportieren Sie die Sperrlisten jeder Mailgun-Domain und importieren Sie sie.
- Legen Sie Ihre Vorlagen und Webhooks neu an.
- Legen Sie einen Sandbox-Schlüssel mit sandboxBehavior LogOnly an und führen Sie Ihre Integrationstests gegen Mail.Land aus, ohne E-Mails zuzustellen.
- Senden Sie echte Nachrichten an Adressen, die Sie kontrollieren, und prüfen Sie sie im E-Mail-Log.
- Verlagern Sie eine Anwendung oder einen kleinen Teil des Volumens und beobachten Sie Zustellung, Bounces und Beschwerden.
- Solange beide Anbieter laufen, halten Sie Abmeldungen in beide Richtungen synchron: Übertragen Sie neue Abmeldungen, Beschwerden und Bounces von Mailgun zu Mail.Land und von Mail.Land zu Mailgun, und synchronisieren Sie ein letztes Mal, bevor Sie das restliche Volumen verlagern.
- Prüfen Sie das Warm-up Ihrer Domain: In Free und Pro hat eine neue Domain ein Tageslimit, das stufenweise steigt; Sendungen darüber werden abgelehnt. Planen Sie den Umzug innerhalb dieser Grenzen oder fragen Sie uns nach einem eigenen Zeitplan. Max überspringt das Warm-up.
- Verlagern Sie dann den Rest und lassen Sie Mailgun aktiv, bis die letzten geplanten und wiederholten Nachrichten verschickt sind.
Quellen
Mailguns öffentliche Seiten, die für diesen Leitfaden verwendet wurden.
- [1]Mailgun-API: eine Nachricht sendenhttps://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/messages/post-v3--domain-name--messagesgeprüft am 4. November 2026
- [2]Mailgun-API: Authentifizierunghttps://documentation.mailgun.com/docs/mailgun/api-reference/authenticationgeprüft am 4. November 2026
- [3]Mailgun: Versand per SMTPhttps://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/send-smtpgeprüft am 4. November 2026
- [4]Mailgun: Versand mit Vorlagenhttps://documentation.mailgun.com/docs/mailgun/user-manual/sending-messages/send-templatesgeprüft am 4. November 2026
- [5]Mailgun: Webhookshttps://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/webhooksgeprüft am 4. November 2026
- [6]Mailgun: Webhooks absichernhttps://documentation.mailgun.com/docs/mailgun/user-manual/webhooks/securing-webhooksgeprüft am 4. November 2026
- [7]Mailgun-API: Bounceshttps://documentation.mailgun.com/docs/mailgun/api-reference/send/mailgun/bounces/get-v3--domainid--bouncesgeprüft am 4. November 2026
Häufige Fragen
Kann ich während der Tests weiter über Mailgun senden?
Ja. Die Verifizierung einer Domain in Mail.Land hindert Mailgun nicht daran, für sie zu senden. Sie können beide parallel betreiben und das Volumen schrittweise verlagern.
Bei Mailgun kann ich eine US- oder EU-Region wählen. Wo läuft Mail.Land?
Bei Mail.Land gibt es keine Regionen zur Auswahl. Die Primärkopie Ihrer Daten liegt in Deutschland; die Anbieter außerhalb der EU stehen auf unserer DSGVO-Seite.
Wie sende ich an viele Empfänger auf einmal?
Verwenden Sie POST /v1/transactional/send-batch mit einem Marketingschlüssel (ml_pem_). Es nimmt bis zu 10.000 Empfänger mit jeweils eigenen Variablen an. Ein Transaktionsschlüssel nimmt bis zu 5 Empfänger pro Anfrage an.
Gibt es ein offizielles Mail.Land-SDK?
Noch nicht. Die Dokumentation enthält Beispiele zum Kopieren für die REST-API in cURL, Node.js, Python, PHP, C#, Java und Go, und jede SMTP-Bibliothek funktioniert mit dem Relay.
Bereit für den Wechsel von Mailgun?
Erstellen Sie ein kostenloses Konto und senden Sie noch heute Ihren ersten Test. Wenn Sie Hilfe möchten, beschreiben Sie uns Ihre Einrichtung.