Zum Hauptinhalt springen

Mailgun: Vollständiger technischer Leitfaden für Transaktions-E-Mails

Von CaptainDNS
Veröffentlicht am 21. Januar 2026

Aktualisiert am 10. November 2026

Mailgun-Dashboard mit Domain Authentication und REST API-Konfiguration
Zusammenfassung
  • 📢 Mailgun verwendet Ihre Domain im Return-Path (bounce+id@ihredomain.com) und ermöglicht native SPF-Ausrichtung für DMARC ab dem Basisplan.
  • Die REST API ist die empfohlene Methode: bis zu 1.000 Empfänger pro Aufruf, undokumentierte Rate Limits (außer Domains API: 300 req/min).
  • Laut Mailgun erfordert die SMTP-Einlieferung ab dem 1. März 2027 TLS 1.2 oder höher: Verbindungen mit TLS 1.0 oder 1.1 werden abgewiesen. Integrationen, die ausschließlich die REST API nutzen, sind von dieser Umstellung nicht betroffen.
  • Automatic Sender Security generiert 2 DKIM-CNAMEs mit automatischer Rotation alle 120 Tage, 2048-Bit-Schlüssel standardmäßig.
  • Dedizierte IP empfohlen ab 1 Million E-Mails/Monat, mit automatischem Warmup über 15+ Tage und Kosten von 59 $/IP/Monat zusätzlich.
  • Flex-Plan erhöht auf 2,00 $/1.000 E-Mails seit Dezember 2025 (Verdoppelung des Tarifs).

Einführung

Mailgun hat sich als eine der robustesten Plattformen für Transaktions-E-Mails auf dem Markt etabliert und verarbeitet über 600 Milliarden E-Mails pro Jahr für mehr als 100.000 Kunden. Im Dezember 2021 von Sinch für 1,9 Milliarden USD übernommen, kombiniert der Service eine leistungsstarke REST API, ein universelles SMTP-Relay und erweiterte Authentifizierungsfunktionen, die ihn von der Konkurrenz abheben.

Die Stärke von Mailgun liegt in drei wichtigen technischen Säulen: einem entwicklerorientierten API-First-Ansatz, einer Domain Verification, die Ihre eigene Domain für den Return-Path verwendet (native SPF-Ausrichtung für DMARC), und einem System zur automatischen Rotation von 2048-Bit-DKIM-Schlüsseln alle 120 Tage ohne Serviceunterbrechung.

Dieser Leitfaden richtet sich an Entwickler, DevOps und Systemarchitekten, die Mailgun für Transaktions-E-Mails mit einem vollständigen Verständnis der Infrastruktur integrieren möchten: DNS-Konfiguration, Wahl zwischen API und SMTP, Verwaltung dedizierter IPs, technische Limits und Event-Webhooks.

REST API vs. SMTP Relay: Architektur und Integrationswahl

Mailgun bietet zwei Integrationsmethoden für Transaktions-E-Mails, beide ab dem kostenlosen Plan verfügbar (100 E-Mails/Tag).

Vergleich zwischen REST API und SMTP Relay

Technischer Vergleich

KriteriumREST APISMTP Relay
Endpointhttps://api.mailgun.net/v3/{domain}/messages (US)smtp.mailgun.org Ports 587/465
AuthentifizierungHTTP Basic Auth (api:YOUR_API_KEY)SASL/PLAIN (postmaster@ + SMTP-Passwort)
Rate LimitUndokumentiert (Domains API: 300 req/min)Abhängig von IP und Plan
Empfänger/reqBis zu 1.000 (to + cc + bcc kombiniert)1 E-Mail = 1 SMTP-Verbindung
VorlagenVariablen mit {{variable}}-SyntaxÜber X-Mailgun-Variables-Header
Zeitplanungo:deliverytime (bis zu 3 Tage, 7d bei 7d+ Speicher)Über X-Mailgun-Deliver-By-Header
TrackingNativ (o:tracking, o:track-clicks, o:track-opens)Über X-Mailgun-Track*-Header
KompatibilitätBenötigt SDK oder HTTP-ClientSMTP-Client mit TLS-1.2-Unterstützung (ab 1. März 2027 erforderlich)
Idealer AnwendungsfallModerne Apps, Batch, erweiterte PersonalisierungLegacy, CMS-Plugins, Mail-Server

Die von Mailgun angekündigte Umstellung auf mindestens TLS 1.2 betrifft die SMTP-Einlieferung. Laut der Ankündigung müssen Absender, die ausschließlich die API nutzen, wegen dieser Umstellung nichts ändern.

Wann sollten Sie die REST API wählen?

Die REST API ist Mailguns empfohlene Methode für jede neue Integration. Sie ist unter POST https://api.mailgun.net/v3/{domain}/messages für die US-Region oder api.eu.mailgun.net für die EU verfügbar.

Hauptvorteile:

  • Batch-Versand: Versand an bis zu 1.000 Empfänger in einer einzigen Anfrage mit Personalisierung über Empfängervariablen
  • Gespeicherte Vorlagen: Handlebars-Syntax mit Bedingungen, Schleifen, benutzerdefinierten Helfern
  • Zeitplanung: Versandplanung bis zu 3 Tage im Voraus (7 Tage, wenn Ihr Plan 7+ Tage Speicherung beinhaltet)
  • Rate-Limit-Header: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset für Monitoring

Beispiel für Versand mit Personalisierung:

curl -s --user 'api:YOUR_API_KEY' \
  https://api.mailgun.net/v3/mail.captaindns.com/messages \
  -F from='Benachrichtigungen <no-reply@mail.captaindns.com>' \
  -F to='user1@captaindns.com' \
  -F to='user2@captaindns.com' \
  -F subject='Neue Benachrichtigung' \
  -F text='Hallo {{vorname}}, Sie haben {{anzahl}} Benachrichtigungen.' \
  -F recipient-variables='{"user1@captaindns.com":{"vorname":"Hans","anzahl":"3"},"user2@captaindns.com":{"vorname":"Maria","anzahl":"7"}}' \
  -F o:tag='benachrichtigung' \
  -F o:tracking='yes'

Offizielle SDKs: Mailgun pflegt SDKs für Go, Node.js, PHP, Python, Ruby und Java, die die REST API kapseln und die Integration vereinfachen.

Wann sollten Sie das SMTP Relay wählen?

Das SMTP Relay eignet sich für Anwendungen, Plugins und Mail-Server, die nur per SMTP senden können. Für ein Legacy-System bleibt es eine Option, sofern Sie zuerst dessen TLS-Stack prüfen: Ab dem 1. März 2027 weist Mailgun nach eigener Ankündigung Verbindungen zur SMTP-Einlieferung mit TLS 1.0 oder 1.1 ab.

Offizielle Konfiguration:

SMTP-Server: smtp.mailgun.org (US) oder smtp.eu.mailgun.org (EU)
SMTP-Benutzer: postmaster@mail.captaindns.com (oder benutzerdefinierter SMTP-Benutzer)
SMTP-Passwort: [Domain-SMTP-Passwort]
Port: 587 (STARTTLS empfohlen) oder 465 (direktes TLS) oder 2525 (GCE-Fallback)
TLS: Mindestversion 1.2, ab sofort konfigurieren (von Mailgun ab 1. März 2027 verlangt)

STARTTLS und direktes TLS beschreiben, wie die verschlüsselte Sitzung aufgebaut wird, nicht die ausgehandelte Version: Ein auf STARTTLS konfigurierter Client kann weiterhin TLS 1.0 aushandeln, wenn seine Bibliothek es zulässt. Auch ein Portwechsel ändert die TLS-Version nicht. Zur Wahl zwischen 587, 465 und 2525 siehe unseren Leitfaden zu SMTP-Ports; zur Mindestversion siehe den entsprechenden Abschnitt.

Kritischer Punkt: Die SMTP-Authentifizierung verwendet das Domain-SMTP-Passwort, das sich vom API-Schlüssel unterscheidet. Der Benutzername ist die postmaster@-Adresse Ihrer verifizierten Domain (oder ein im Dashboard erstellter benutzerdefinierter SMTP-Benutzer).

Proprietäre X-Mailgun-*-Header: Ermöglichen Zugriff auf erweiterte Funktionen über SMTP (Tags, Tracking, Vorlagen, Zeitplanung, Variablen). Vollständige Liste:

  • X-Mailgun-Tag: Tag für Statistiken (mehrere möglich)
  • X-Mailgun-Track: Globales Tracking aktivieren/deaktivieren
  • X-Mailgun-Track-Clicks: Klick-Tracking (yes/no/htmlonly)
  • X-Mailgun-Track-Opens: Öffnungs-Tracking (yes/no)
  • X-Mailgun-Deliver-By: Zeitplanung (RFC 2822-Format oder Unix-Timestamp)
  • X-Mailgun-Template-Name: Zu verwendender Vorlagenname
  • X-Mailgun-Variables: Vorlagenvariablen (JSON)

Domain Verification: SPF, 2048-Bit-DKIM und native DMARC-Ausrichtung

Die DNS-Konfiguration in Mailgun generiert die notwendigen Einträge für SPF, DKIM und DMARC-Ausrichtung. Der Prozess wird unter Sending > Domains > Domain settings > Domain verification durchgeführt.

Architektur mit Automatic Sender Security (empfohlen)

Mit aktivierter Automatic Sender Security-Option (empfohlen) generiert Mailgun 2 DKIM-CNAME-Einträge für die automatische Schlüsselrotation:

Mailgun Domain Verification-Konfiguration

Erforderliche Einträge (Beispiel für mail.captaindns.com):

TypName/HostWertZweck
TXTmail.captaindns.comv=spf1 include:mailgun.org ~allSPF
CNAMEpdk1._domainkey.mail.captaindns.compdk1._domainkey.XXXX.dkim1.mailgun.comDKIM-Rotation (Selektor 1)
CNAMEpdk2._domainkey.mail.captaindns.compdk2._domainkey.XXXX.dkim1.mailgun.comDKIM-Rotation (Selektor 2)
MXmail.captaindns.commxa.mailgun.org (Priorität 10)Bounces/Inbound
MXmail.captaindns.commxb.mailgun.org (Priorität 10)Bounces/Inbound

EU-Region-Hinweis: Für die EU verwenden MX-Einträge mxa.eu.mailgun.org und mxb.eu.mailgun.org.

Vorteile dieser Architektur:

  • Automatische DKIM-Schlüsselrotation: Die beiden Selektoren (pdk1 und pdk2) ermöglichen es Mailgun, Schlüssel alle 120 Tage ohne Serviceunterbrechung zu ändern
  • 2048-Bit-DKIM-Schlüssel standardmäßig (manuelle TXT-Konfigurationen können 1024 Bit verwenden, aber 2048 empfohlen)
  • Kein Tracking-CNAME-Eintrag standardmäßig erforderlich: Mailgun verwendet mailgun.org (oder eu.mailgun.org für die EU)
  • DKIM-Selektoren: pdk1 und pdk2 für Automatic Security oder mx für manuelle TXT-Konfiguration

Return-Path und SPF-Ausrichtung: ein großer Vorteil

Der Return-Path (Envelope From) ist entscheidend für die DMARC-Ausrichtung. Mailgun verwendet automatisch Ihre Domain für den Return-Path im Format bounce+UNIQUEID@mail.captaindns.com:

  • SPF wird automatisch bestanden, da der include:mailgun.org-Eintrag Mailgun-IPs autorisiert, für Ihre Domain zu senden
  • SPF-Ausrichtung funktioniert im relaxed-Modus (der Return-Path bounce+id@mail.captaindns.com entspricht der übergeordneten Domain mail.captaindns.com)
  • Keine separate Konfiguration erforderlich: Im Gegensatz zu anderen Anbietern benötigt Mailgun keine dedizierte Subdomain für die Bounce-Domain

Unterschied zu Mitbewerbern:

  • SendGrid: Verwendet eine anpassbare Subdomain (em1234.captaindns.com)
  • Amazon SES: Benötigt Custom MAIL FROM für SPF-Ausrichtung
  • Mailgun: Verwendet direkt Ihre verifizierte Domain

Für eine strikte DMARC-Richtlinie (aspf=s) schlägt die SPF-Ausrichtung fehl, wenn Sie von einer anderen Subdomain als dem Return-Path senden. Die Lösung besteht darin, sich auf DKIM für die DMARC-Ausrichtung zu verlassen, das den strikten Modus (adkim=s) unterstützt.

Die Tracking-Domain ersetzt Mailgun-Domains in getracke Links durch Ihre eigene Domain. Standardmäßig verwendet Mailgun email.mail.captaindns.com, das über CNAME auf mailgun.org (US) oder eu.mailgun.org (EU) zeigt.

Optionale HTTPS-Konfiguration: Mailgun generiert automatisch ein Let's Encrypt-Zertifikat, sobald der CNAME verifiziert ist.

Migration zu 2048-Bit-DKIM

Um eine manuelle TXT-Konfiguration (1024-Bit-Schlüssel) zu Automatic Sender Security (2048 Bit) zu migrieren, aktivieren Sie einfach Automatic Sender Security im Dashboard und erstellen dann die 2 neuen DKIM-CNAMEs. Der Übergang ist dank der beiden Selektoren reibungslos.

E-Mail-Authentifizierungsfluss: von der API zur Zustellbarkeit

Mailgun E-Mail-Authentifizierungsfluss mit DKIM, SPF und DMARC

Wenn Sie über Mailgun senden:

  1. Ihre Anwendung ruft die REST API auf oder verwendet SMTP
  2. Mailgun signiert die Nachricht mit Ihrem DKIM-Schlüssel (Domain d=mail.captaindns.com)
  3. Mailgun verwendet Ihre Domain im Return-Path (bounce+id@mail.captaindns.com)
  4. Der Empfänger-Server überprüft SPF (sendende IP), DKIM (Signatur), dann DMARC (Ausrichtung)
  5. SPF wird bestanden: include:mailgun.org autorisiert Mailgun-IPs, Return-Path verwendet Ihre Domain
  6. DKIM wird bestanden: Signatur d=mail.captaindns.com entspricht dem From-Header
  7. DMARC wird bestanden: Mindestens SPF UND DKIM sind ausgerichtet (doppelte Validierung)

DMARC-Ausrichtung: Konfiguration für p=reject

Was funktioniert (und was nicht)

DKIM-Ausrichtung:

KonfigurationAusgerichtet?DMARC über DKIM?
Domain mit aktiviertem DKIM (TXT oder CNAME)JaJa

SPF-Ausrichtung:

KonfigurationAusgerichtet?DMARC über SPF?
Return-Path verwendet Ihre Domain (nativ)JaJa
aspf=r (relaxed, Standard)JaJa
aspf=s (strict) + Versand von SubdomainNeinNein (Subdomain-Nichtübereinstimmung)

Empfohlener DMARC-Eintrag

_dmarc.captaindns.com  TXT  "v=DMARC1;p=reject;adkim=r;aspf=r;rua=mailto:dmarc@captaindns.com"

Wichtige Punkte:

  • adkim=r und aspf=r: Relaxed-Ausrichtung (erlaubt Subdomains)
  • Fortschritt von p=none → p=quarantine → p=reject
  • Überwachen Sie rua-Berichte, bevor Sie verschärfen
  • Mailgun-Vorteil: Native doppelte Ausrichtung (SPF + DKIM), besserer Schutz als nur mit DKIM

Vollständige DNS-Übersichtstabelle

TypHost/NameWertErforderlichHinweise
TXTmail.captaindns.comv=spf1 include:mailgun.org ~all✅ JaSPF identisch US/EU
CNAMEpdk1._domainkey.mail.captaindns.compdk1._domainkey.XXXX.dkim1.mailgun.com✅ JaDKIM-Auto-Rotation
CNAMEpdk2._domainkey.mail.captaindns.compdk2._domainkey.XXXX.dkim1.mailgun.com✅ JaDKIM-Auto-Rotation
MXmail.captaindns.commxa.mailgun.org (Priorität 10)✅ JaBounces/Inbound
MXmail.captaindns.commxb.mailgun.org (Priorität 10)✅ JaBounces/Inbound
TXT_dmarc.captaindns.comv=DMARC1;p=reject;adkim=r;aspf=r;...EmpfohlenDMARC-Richtlinie
CNAMEemail.mail.captaindns.commailgun.org oder eu.mailgun.orgOptionalTracking-Domain

Dedizierte IP vs. gemeinsame IP: Zustellbarkeitsstrategie

Mailgun empfiehlt offiziell eine dedizierte IP ab 1 Million E-Mails pro Monat. Darunter bietet die gemeinsame IP in der Regel eine bessere Zustellbarkeit.

Gemeinsame IP (Free-, Foundation-, Basis-Growth-Pläne)

Vorteile:

  • Kein Warmup erforderlich
  • Reputation wird von Mailgun gepflegt
  • Ideal für niedrige oder unregelmäßige Volumen
  • Bessere anfängliche Zustellbarkeit als auf kalter dedizierter IP

Nachteile:

  • Exposition gegenüber Reputationsrisiken anderer Absender im Pool (selten bei Mailgun dank strenger Kontrollen)

Dedizierte IP (Foundation 100k+, Growth, Scale, Enterprise)

Der Foundation 100k-Plan enthält 1 dedizierte IP (ab 75 $/Monat). Jede zusätzliche IP kostet 59 $/IP/Monat.

Offizielle Empfehlung: 1 dedizierte IP für ungefähr 1 Million E-Mails pro Monat Minimum.

Vorteile:

  • Isolierte und kontrollierbare Reputation
  • Automatische IP-Warmup-Funktion über 15 Schritte (~15+ Tage)
  • Möglichkeit, Flows zu trennen (transaktional vs. Marketing) über IP-Pools

Automatisches IP-Warmup: Mailgun bietet ein progressives Warmup in 15 Schritten:

SchrittTageslimitStundenlimitDauer
11.00010024h
22.500~10024h
35.000Progressiv24h
...ProgressivProgressiv...
15Volle KapazitätUnbegrenztErreicht Tag 15+

Das System schreitet alle 24 Stunden einen Schritt voran, wenn die Limits erreicht werden. Überschüssiger Verkehr wird automatisch zu gemeinsamen IPs oder anderen verfügbaren dedizierten IPs geleitet.

IP-Pools: Verfügbar bei Scale- und höheren Plänen. Ermöglichen:

  • Trennung von transaktionalen vs. Marketing-E-Mails
  • Verschiedene Kunden/Marken (Multi-Tenant)
  • Dynamische IP-Pools: Automatische Zuweisung basierend auf Reputationsgesundheit

Wichtiger Hinweis: Dedizierte IPs sind regionsgebunden (US oder EU). Eine Regionsmigration erfordert eine neue IP und ein neues Warmup.

Wann sollten Sie eine dedizierte IP wählen?

Sie benötigen eine dedizierte IP, wenn:

  • Regelmäßiges Volumen > 1 Million E-Mails/Monat
  • Notwendigkeit, transaktionale vs. Marketing-Reputation zu trennen
  • Kundenwhitelisting-Anforderungen oder regulatorische Compliance
  • Volumen > 2,5 Millionen E-Mails/Monat: Mehrere dedizierte IPs empfohlen

Bleiben Sie bei gemeinsamer IP, wenn:

  • Volumen < 1 Million E-Mails/Monat
  • Unregelmäßiger oder sporadischer Versand
  • Geschäftsstart ohne Historie
  • Rein transaktional mit niedrigem Volumen

Preise 2026 und aktuelle Entwicklung

Send-Pläne (Januar 2026)

PlanPreis/MonatEnthaltene E-MailsÜberschreitung (/1.000)Log-AufbewahrungDedizierte IP
Free0 $100/TagN/A1 TagNein
FlexPay-per-use1.000 kostenlos/Monat2,00 $ ⚠️5 TageNein
Foundation 50k35 $50.000~1,30 $5 TageNein
Foundation 100k75 $100.000~1,30 $5 Tage1 enthalten
Growth80-650 $100k-1MVariabel15 Tage1 enthalten
Scale 100k90 $100.000~0,80-1,10 $30 Tage1 enthalten
Scale (max)1.250 $2,5MVariabel30 Tage1 enthalten
EnterpriseAuf Anfrage2,5M+Verhandelt30 TageMehrere

Aktuelle Preisentwicklung

⚠️ Wesentliche Änderung (1. Dezember 2025): Der Flex-Plan stieg von 1,00 $ auf 2,00 $ pro 1.000 E-Mails - eine Erhöhung um 100%. Diese erhebliche Erhöhung macht Foundation-Pläne für Volumen > 25.000 E-Mails/Monat viel attraktiver.

Wirtschaftliche Analyse:

  • Flex-Plan: 50.000 E-Mails = 49.000 bezahlt × 0,002 $ = 98 $
  • Foundation 50k-Plan: 50.000 E-Mails = 35 $ (Ersparnis 63 $)
  • Break-Even-Punkt: Der Foundation-Plan wird rentabel ab ~18.000 E-Mails/Monat

Optimize-Pläne (Zustellbarkeitstools)

PlanPreis/MonatValidierungenInbox-TestsVorschauen
Pilot49 $2.50025500
Starter99 $5.000501.000
ContractAuf AnfrageAngepasstAngepasstAngepasst

Jahresrabatte

Nicht öffentlich dokumentiert. Enterprise-Kunden berichten von verhandelbaren Rabatten von 10%+.

US vs. EU-Preise

Die Preisgestaltung ist weltweit standardisiert in USD. Kein dokumentierter regionaler Unterschied zwischen US und EU.

Technische Limits und Kontingente

LimitWertHinweise
Max. E-Mail-Größe25 MBKörper + Anhänge + Header
Empfänger/Nachricht1.000To + Cc + Bcc kombiniert
Send-Options-Parameter16 KBParameter o:, h:, v:, t:
Vorlagen/Domain100Striktes Limit
Versionen/Vorlage10-
Domains (Free)5-
Domains (bezahlt)1.000-
Sandbox-Empfänger5Müssen verifiziert sein
Domains-API-Rate-Limit300 req/minEinziger dokumentierter Endpunkt
Versand-Rate-Limit (neue Konten)100 Nachrichten/StundeVor Geschäftsverifizierung
Zeitplanung max.3 Tage7 Tage bei Plan mit 7d+ Speicherung

Datenaufbewahrung

DatenAufbewahrung
Event-Logs (Free)1 Tag
Event-Logs (Foundation)5 Tage
Event-Logs (Growth)15 Tage
Event-Logs (Scale)30 Tage (max)
Nachrichteninhalt1-7 Tage (konfigurierbar)
Stündliche Statistiken60 Tage
Tägliche Statistiken1 Jahr
Monatliche StatistikenUnbegrenzt
Kritische Sicherheitslogs365 Tage

Bounce- und Suppressions-Verwaltung

Hard Bounce (permanenter Fehler)

VerhaltenDetail
AktionAdresse zur Suppressionsliste hinzugefügt
BlockdauerUnbegrenzt (bis zur manuellen Entfernung)
Zurückgegebener Fehler"Not delivering to previously bounced address"

Soft Bounce (temporärer Fehler)

VerhaltenDetail
RetryAutomatisch für sofortige Soft Bounces
DauerBis zum Erfolg oder permanenten Klassifizierung
KonvertierungNach mehreren Fehlern zur Bounce-Liste hinzugefügt

Spam-Beschwerden (FBL)

Mailgun abonniert automatisch Feedback Loops großer ISPs. Beschwerden lösen aus:

  • Automatisches Hinzufügen zur Complaints-Liste
  • complained-Webhook gesendet
  • Blockierung zukünftiger Sendungen an diese Adresse

Unterstützte ISPs: Yahoo, Microsoft/Outlook, Comcast, Cox, Fastmail und andere über Universal Feedback Loop. Hinweis: Gmail bietet keine traditionelle FBL.

Automatisches Abmelden

Mailgun fügt automatisch hinzu:

  • List-Unsubscribe-Header
  • List-Unsubscribe-Post: List-Unsubscribe=One-Click-Header

RFC 8058-konform und erfüllt Gmail/Yahoo-Anforderungen für Massen-Absender (5.000+ Nachrichten/Tag).

Suppressionslisten-API

ListeEndpunkt
BouncesGET/POST/DELETE /v3/{domain}/bounces
ComplaintsGET/POST/DELETE /v3/{domain}/complaints
UnsubscribesGET/POST/DELETE /v3/{domain}/unsubscribes
AllowlistGET/POST/DELETE /v3/{domain}/allowlist

Die Allowlist verhindert, dass Adressen zur Bounces-Liste hinzugefügt werden, überschreibt jedoch nicht Complaints oder Unsubscribes.

Event-Webhook und Echtzeit-Tracking

Der Event-Webhook ermöglicht Echtzeit-Benachrichtigungen über Zustellung, Engagement und Compliance.

Verfügbare Events

  • Zustellung: accepted, delivered, temporary_fail, permanent_fail
  • Engagement: opened, clicked
  • Compliance: complained, unsubscribed

JSON-Payload-Format

{
  "signature": {
    "timestamp": "1529006854",
    "token": "a8ce0edb2dd8301dee6c2405235584e45aa91d1e9f979f3de0",
    "signature": "d2271d12299f6592d9d44cd9d250f0704e4674c30d79d07c47a66f95ce71cf55"
  },
  "event-data": {
    "event": "delivered",
    "timestamp": 1529006854.329574,
    "id": "DACSsAdVSeGpLid7TN03WA",
    "recipient": "recipient@captaindns.com",
    "tags": [],
    "message": {
      "headers": {
        "message-id": "20180618211821.captaindns.com"
      }
    }
  }
}

Retry-Richtlinie

AntwortcodeAktion
200Erfolg, kein Retry
406Abgelehnt, kein Retry
AndereRetry gemäß Zeitplan

Retry-Zeitplan: 5min → 10min → 15min → 1h → 2h → 4h (gesamt: 8 Stunden)

Sicherheit (HMAC-Signatur)

ElementWert
AlgorithmusHMAC-SHA256
SchlüsselWebhook Signing Key (Control Panel → Account Security)
BerechnungHMAC-SHA256(timestamp + token, signingKey)

Python-Beispiel:

import hmac, hashlib
def verify(api_key, token, timestamp, signature):
    expected = hmac.new(api_key.encode(), f"{timestamp}{token}".encode(), 
                        hashlib.sha256).hexdigest()
    return signature == expected

Konfiguration

  • Bis zu 3 URLs pro Event-Typ pro Domain
  • Konfiguration auf Domain-Ebene (nicht Konto)
  • API: POST /v3/domains/{domain}/webhooks

Handlebars-Vorlagen

Mailgun verwendet Handlebars (angepasste Version) für gespeicherte Vorlagen.

Variablensyntax

KontextSyntax
Gespeicherte Vorlagen{{variable}}
Inline-Batch-Versand (API)%recipient.variable%

Bedingungen und Schleifen

{{#if bedingung}}
  Inhalt wenn wahr
{{else if andereBedingung}}
  Alternativer Inhalt
{{else}}
  Standard-Inhalt
{{/if}}

{{#unless bedingung}}
  Inhalt wenn falsch
{{/unless}}

{{#equal variable "wert"}}
  Inhalt wenn gleich
{{/equal}}

{{#each array}}
  <li>{{this.eigenschaft}}</li>
{{/each}}

{{#with objekt}}
  {{verschachtelteEigenschaft}}
{{/with}}

Vorlagen-Limits

LimitWert
Vorlagen pro Domain100
Versionen pro Vorlage10
VorlagengrößeUndokumentiert
Partials (Import)Nicht unterstützt

Zusätzliche Funktionen

E-Mail-Validierungs-API

AttributWert
Einzel-EndpunktGET /v4/address/validate?address=...
Bulk-EndpunktPOST /v4/address/validate/bulk/{list_id}
Datenbank450+ Milliarden E-Mails
Foundation-Rate1,20 $/100 Validierungen
Scale-Rate5.000 enthalten, dann 0,80 $/100

Durchgeführte Validierungen: RFC-Syntax, MX-Einträge, Mailbox-Existenz, Mailgun-Netzwerk-Bounces, riskante Adressen, rollenbasierte Adressen, Wegwerf-E-Mails, Domain-Tippfehler, Catch-All-Domains.

Inbound Parse (Routen)

Ermöglicht das Empfangen von E-Mails und deren Weiterleitung an eine Webhook-URL:

Filter: match_recipient(), match_header(), catch_all()
Aktionen: forward("https://url"), forward("email@"), store(), stop()

Inbound-Retry: bis zu 8 Stunden (10min, 15min, 30min, 1h, 2h, 4h) Gespeicherte Nachrichtenaufbewahrung: 3 Tage

Anhänge

LimitWert
Gesamte Nachrichtengröße25 MB (Körper + Anhänge + Header)
DateitypenKeine dokumentierte Einschränkung
Inline (CID)Unterstützt über inline-Parameter

AMP für E-Mail

Unterstützt seit 2019 über den amp-html-Parameter. Erfordert:

  • Registrierung als AMP-Absender bei Google
  • SPF, DKIM, DMARC konfiguriert
  • Obligatorischer HTML-Fallback

Sicherheit und Compliance

Zertifizierungen

ZertifizierungStatus
ISO 27001✅ Zertifiziert
ISO 27701✅ Zertifiziert (Datenschutz)
SOC 2 Type I✅ Zertifiziert
SOC 2 Type II✅ Zertifiziert
SOC 1 (SSAE-16)✅ Zertifiziert
PCI-DSS✅ Konform (SAQ-A)
CSA Star Level 1✅ Konform

DSGVO

ElementDetail
DPAVerfügbar: mailgun.com/legal/dpa/
EU-DatenspeicherortDeutschland
EU-Endpunkteapi.eu.mailgun.net, smtp.eu.mailgun.org
DatenresidenzNachrichten werden nie außerhalb der Region übertragen
DSBDediziert, EU-basiert

HIPAA

ElementDetail
Status✅ Konform
BAAVerfügbar: mailgun.com/legal/hipaa-baa/
VoraussetzungenClient-seitige Verschlüsselungskonfiguration, Patienteneinwilligung, signierte BAA

SMTP-Einlieferung: mindestens TLS 1.2 ab dem 1. März 2027

In seiner Ankündigung vom 9. November 2026 teilt Mailgun mit, dass Verbindungen zur SMTP-Einlieferung ab dem 1. März 2027 TLS 1.2 oder höher verwenden müssen. Verbindungen mit TLS 1.0 oder TLS 1.1 werden abgewiesen, und die betroffenen Nachrichten werden laut Mailgun nicht versendet. Integrationen, die ausschließlich die REST API nutzen, sind von dieser Umstellung nicht betroffen. Mailgun begründet den Schritt mit den bekannten Schwächen dieser beiden Versionen, durch die Nachrichten und SMTP-Zugangsdaten bei der Übertragung angreifbar werden.

Die Regel betrifft die Strecke zwischen Ihrem Absendersystem (Anwendung, Plugin, Relay) und Mailgun. Die Ankündigung unterscheidet nicht nach Regionen, und ihre Beispiele verwenden smtp.mailgun.org: Für eine EU-Domain führen Sie dieselben Prüfungen mit smtp.eu.mailgun.org durch. Die nachfolgende Strecke, von Mailgun zum Server des Empfängers, ist davon getrennt. Der Header X-Mailgun-Require-TLS erzwingt laut Mailgun eine gesicherte Verbindung auf dieser ausgehenden Strecke; an der Version, die Ihre Anwendung bei der Einlieferung aushandelt, ändert er nichts. Zum Unterschied zwischen STARTTLS und implizitem TLS siehe unseren eigenen Leitfaden.

VersionNormativer StatusSMTP-Einlieferung bei Mailgun
TLS 1.0Von der IETF im März 2021 als veraltet eingestuft (RFC 8996)Abweisung ab 1. März 2027 angekündigt
TLS 1.1Von der IETF im März 2021 als veraltet eingestuft (RFC 8996)Abweisung ab 1. März 2027 angekündigt
TLS 1.2Nicht von RFC 8996 erfasstAngekündigtes Minimum ab 1. März 2027
Höher als 1.2Nicht von RFC 8996 erfasstNach der angekündigten Richtlinie ("TLS 1.2 oder höher") zulässig, sofern die Aushandlung gelingt

März 2021 ist das Datum der normativen Einstufung als veraltet, nicht das einer Abweisung durch Mailgun. Ebenso wenig belegt die Richtlinie "TLS 1.2 oder höher", dass jeder Endpunkt und jeder Port TLS 1.3 aushandelt: Dieser Leitfaden hat das nicht geprüft. Was mit abgewiesenen Nachrichten geschieht, hängt anschließend vom Client ab: Ein Relay behält die Nachricht in der Regel in der Warteschlange und versucht es erneut, eine Anwendung, die es nicht erneut versucht, verschickt die Nachricht unter Umständen nie.

Laut Mailgun erhalten Administratoren eine E-Mail und sehen ein Banner im Dashboard, wenn auf einem Konto ältere TLS-Versionen erkannt werden. Fehlt das Banner, beweist das nicht, dass alle Ihre Absendersysteme konform sind, insbesondere solche, die selten senden.

Bestandsaufnahme der SMTP-Absender

Mailgun weist darauf hin, dass viele Teams mehrere Anwendungen haben, die über dasselbe Konto senden. Suchen Sie überall, wo Ihre Mailgun-SMTP-Zugangsdaten oder der Host smtp.mailgun.org (smtp.eu.mailgun.org für die EU) vorkommen:

  • Ihre Anwendungen und Dienste, einschließlich der Staging-Umgebung und der Hintergrundprozesse (Worker);
  • Mail-Server oder Relays wie Postfix, die an Mailgun weiterleiten;
  • CMS-Plugins, E-Commerce-Plattformen und andere Tools, die mit Ihren SMTP-Zugangsdaten konfiguriert sind;
  • Drittanbieter- oder Altsysteme, die Warnmeldungen versenden: CRM, ERP, Scanner, Überwachungstools.

Vorrangig zu prüfende Umgebungen

Mailgun nennt Umgebungen, die bekanntermaßen Probleme bereiten. Die Liste ist nicht vollständig, und ein darin aufgeführtes System ist nicht zwangsläufig inkompatibel:

  • Windows Server 2008 oder 2012, wo TLS 1.2 standardmäßig nicht aktiviert ist;
  • .NET Framework 4.5 oder älter;
  • veraltete kompilierte OpenSSL-Versionen sowie Anwendungen oder Plugins, die eine alte TLS-Version fest vorgeben.

Endpunkt vom sendenden Rechner aus prüfen

Mailgun schlägt diesen Befehl vor:

openssl s_client -connect smtp.mailgun.org:587 -starttls smtp -tls1_2

Er prüft genau eine Sache: dass sich von diesem Rechner zu diesem Endpunkt, auf diesem Port, eine auf TLS 1.2 festgelegte STARTTLS-Verbindung aufbauen lässt. Für ein EU-Konto ersetzen Sie den Host durch smtp.eu.mailgun.org. Für Port 465 (direktes TLS) ersetzen Sie :587 durch :465 und entfernen -starttls smtp. Mit -tls1_2 erzwingt der Befehl TLS 1.2: Er testet nicht "TLS 1.2 oder höher".

Er misst nicht:

  • die Version, die Ihre Anwendung mit ihrer eigenen Bibliothek und Konfiguration tatsächlich aushandelt;
  • die anderen Instanzen, Container oder Server, die dieselben Zugangsdaten verwenden;
  • die SMTP-Authentifizierung oder die Zustellung einer Nachricht;
  • die strikte Zertifikatsprüfung, die eine erfolgreiche Aushandlung nicht belegt.

TLS 1.2 als Minimum je nach Stack konfigurieren

StackMindestversionVor der Authentifizierung erforderliche Verschlüsselung
Python (smtplib)context.minimum_version = ssl.TLSVersion.TLSv1_2 auf ssl.create_default_context()server.starttls(context=context) vor login(); löst einen Fehler aus, wenn der Server STARTTLS nicht anbietet
Node.js (Nodemailer)tls: { minVersion: "TLSv1.2" }Auf 587 requireTLS: true, um STARTTLS zu erzwingen; auf 465 secure: true
Postfix 3.6 oder neuersmtp_tls_protocols = >=TLSv1.2 und smtp_tls_mandatory_protocols = >=TLSv1.2 in main.cf, danach neu ladenStufe secure: TLS verpflichtend, Zertifikatskette und Name des Relays geprüft (Details unten)

Für Postfix handelt es sich um smtp_-Parameter (ausgehender Client): Ändern Sie nicht stattdessen die smtpd_-Parameter, die den eingehenden Server steuern. Vor Postfix 3.6 lautet derselbe Ausschluss !SSLv2, !SSLv3, !TLSv1, !TLSv1.1.

Die Stufe encrypt erzwingt TLS, ohne das Serverzertifikat zu prüfen: Ein aktiver Angreifer auf dem Übertragungsweg kann sein eigenes vorlegen und SMTP-Zugangsdaten und Nachrichten abgreifen, selbst bei TLS 1.2. Für eine authentifizierte Einlieferung verlangen Sie die Stufe secure. Sie validiert die Zertifikatskette gegen vertrauenswürdige Zertifizierungsstellen und prüft, ob das Zertifikat zum Namen des Relays passt (smtp_tls_secure_cert_match, Standardwert nexthop, dot-nexthop). Geben Sie diese Zertifizierungsstellen mit smtp_tls_CAfile oder smtp_tls_CApath an, zum Beispiel den Zertifikatsspeicher des Systems. Bei relayhost = [smtp.mailgun.org]:587 deaktivieren die eckigen Klammern die MX-Auflösung: Geprüft wird der Name des Relays.

  • Relay ausschließlich für Mailgun: smtp_tls_security_level = secure in main.cf.
  • Relay, das auch andere Ziele bedient: ein smtp_tls_policy_maps-Eintrag pro Mailgun-Relay, zum Beispiel [smtp.mailgun.org]:587 secure match=smtp.mailgun.org oder [smtp.eu.mailgun.org]:587 secure match=smtp.eu.mailgun.org für die EU. Der Schlüssel übernimmt den Wert von relayhost, einschließlich Klammern und Port.

Wenn Ihre Konfiguration bereits verify oder secure anwendet, ersetzen Sie sie nicht durch encrypt, das den Schutz schwächen würde. Auf Anwendungsseite prüfen ssl.create_default_context() und Nodemailer das Zertifikat standardmäßig: Deaktivieren Sie diese Prüfung nicht, etwa mit rejectUnauthorized: false in Nodemailer.

Für .NET Framework 4.5 empfiehlt Mailgun, diese Zeile vor dem Verbindungsaufbau einzufügen, und gibt an, dass die Versionen 4.6 und neuer standardmäßig TLS 1.2 verwenden:

System.Net.ServicePointManager.SecurityProtocol |= SecurityProtocolType.Tls12;

Das ist keine universelle Lösung. Der Operator |= fügt TLS 1.2 hinzu, ohne TLS 1.0 oder 1.1 zu entfernen, und das Ergebnis hängt außerdem vom verwendeten SMTP-Client, von der Systemkonfiguration und vom Ziel-Framework der Anwendung ab.

Tatsächliche Aushandlung validieren

Aussagekräftig ist die Prüfung aus der Laufzeitumgebung jedes Absendersystems, mit dessen tatsächlicher Bibliothek und Konfiguration:

  1. Lesen Sie die ausgehandelte Version in den TLS-Logs des Clients oder des Relays ab, ohne dort Zugangsdaten offenzulegen. Bei Postfix protokolliert smtp_tls_loglevel = 1 eine Zusammenfassung jeder ausgehenden TLS-Sitzung; in Python gibt server.sock.version() die Version nach starttls() zurück.
  2. Senden Sie eine kontrollierte Nachricht an ein dafür freigegebenes Postfach.
  3. Prüfen Sie in Sending > Logs, dass Mailgun sie angenommen und verarbeitet hat.

Tun Sie das vor dem 1. März 2027 für jedes Absendersystem aus der Bestandsaufnahme, nicht nur für die Hauptanwendung.

Verschlüsselung im Ruhezustand

Ruhende Daten werden laut der ursprünglichen Fassung dieses Leitfadens mit AES-256 verschlüsselt. Die Ankündigung vom 9. November 2026 betrifft diesen Punkt nicht; er wurde bei dieser Aktualisierung nicht erneut geprüft.

Erweiterte Authentifizierung

FunktionVerfügbarkeit
2FA✅ Alle Pläne
SSO✅ Scale und Enterprise
SAML 2.0✅ Scale und Enterprise
Unterstützte IdPOkta, Auth0, OneLogin, Azure AD, ADFS, AWS IAM
RBAC✅ Scale und Enterprise (Admin, Developer, Analyst, Support)

Aktionsplan: 6-Schritte-Konfiguration

1. Konto erstellen und Domain konfigurieren

  • Mailgun-Konto erstellen unter mailgun.com/signup
  • Region wählen (US oder EU je nach DSGVO-Anforderungen)
  • Eine Sandbox-Domain wird automatisch erstellt (100 E-Mails/Tag)

2. Domain verifizieren (Domain Verification)

  • Gehen Sie zu Sending > Domains > Add New Domain
  • Geben Sie Ihre Versand-Domain ein (z.B. mail.captaindns.com)
  • Automatic Sender Security aktivieren (empfohlen)
  • DNS-Einträge bei Ihrem Registrar erstellen:
    1. SPF TXT: v=spf1 include:mailgun.org ~all
    2. DKIM CNAME pdk1: pdk1._domainkey.mail.captaindns.com
    3. DKIM CNAME pdk2: pdk2._domainkey.mail.captaindns.com
    4. MX mxa: mxa.mailgun.org (Priorität 10)
    5. MX mxb: mxb.mailgun.org (Priorität 10)
  • DNS-Propagation überprüfen (24-48h)

3. DMARC-Eintrag veröffentlichen

DMARC-Eintrag auf Ihrer Hauptdomain erstellen:

_dmarc.captaindns.com  TXT  "v=DMARC1;p=none;rua=mailto:dmarc@captaindns.com;aspf=r;adkim=r"

Beginnen Sie mit p=none, um zu beobachten, ohne zu blockieren, und wechseln Sie dann zu p=quarantine und anschließend zu p=reject, sobald die Berichte validiert sind.

4. Versandmethode wählen und konfigurieren

Option A: REST API

  • API-Schlüssel generieren unter Settings > API Keys
  • Berechtigungen wählen (Full Access oder Domain Sending Keys für begrenzten Bereich)
  • POST /v3/{domain}/messages-Endpunkt implementieren
  • Vorlagen erstellen unter Sending > Templates falls benötigt

Option B: SMTP Relay

  • Domain-SMTP-Passwort abrufen unter Sending > Domains > Domain settings > SMTP credentials
  • App/Plugin/Mail-Server konfigurieren:
    • Host: smtp.mailgun.org (US) oder smtp.eu.mailgun.org (EU)
    • Port: 587 (STARTTLS empfohlen)
    • Benutzer: postmaster@mail.captaindns.com
    • Passwort: das Domain-SMTP-Passwort
  • Verschlüsselung vor der Authentifizierung erzwingen und TLS 1.2 als Mindestversion festlegen (Einstellungen je Stack im TLS-Abschnitt)
  • Alle Deployments prüfen, die diese Zugangsdaten verwenden (Staging, Hintergrundprozesse, Relays, Plugins, Drittanbieter-Tools), nicht nur die Hauptanwendung
  • Vor dem 1. März 2027 die von jedem Absendersystem tatsächlich ausgehandelte TLS-Version validieren

5. Webhooks konfigurieren

  • Gehen Sie zu Sending > Webhooks
  • Endpunkt-URL definieren (HTTPS empfohlen)
  • Events auswählen (delivered, bounced, opened, clicked, etc.)
  • Webhook Signing Key abrufen zur Validierung von HMAC-Signaturen

6. Testen und überwachen

  • Test-E-Mail über API oder SMTP senden
  • Bei SMTP diesen Versand aus der echten Anwendung heraus durchführen und die TLS-Version ihrer Sitzung festhalten: Das ist aussagekräftiger als ein openssl-Test von einem anderen Rechner aus
  • In Sending > Logs überprüfen, dass die E-Mail zugestellt wurde
  • Webhook-Events auf Ihrem Endpunkt überprüfen
  • Statistiken überwachen (Zustellbarkeit, Öffnungsrate, Bounce-Rate)
  • Für Produktion Sandbox-Modus verlassen durch Kontaktaufnahme mit Mailgun-Support (Geschäftsverifizierung)

Technische Anleitungen: andere transaktionale E-Mail-Plattformen

Entdecken Sie unsere vollständigen Anleitungen für andere transaktionale E-Mail-Lösungen:

FAQ

Wann lehnt Mailgun TLS 1.0 und TLS 1.1 bei SMTP ab?

Ab dem 1. März 2027, laut der Ankündigung, die Mailgun am 9. November 2026 veröffentlicht hat. Ab diesem Datum muss die SMTP-Einlieferung bei Mailgun TLS 1.2 oder höher verwenden, und Verbindungen mit TLS 1.0 oder 1.1 werden abgewiesen. Die IETF hat diese beiden Versionen im März 2021 als veraltet eingestuft (RFC 8996): Das ist ein normativer Status, nicht das Datum einer Abweisung durch Mailgun. Eine Uhrzeit für die Umstellung nennt die Ankündigung nicht.

Ist die REST API von Mailgun von dieser TLS-Umstellung betroffen?

Nein. Laut der Ankündigung vom 9. November 2026 gilt die Änderung nur für den SMTP-Versand, und Absender, die ausschließlich die API nutzen, müssen wegen dieser Umstellung nichts ändern. Das heißt nicht, dass die API ohne TLS funktioniert: Sie wird über HTTPS aufgerufen. Läuft ein Teil Ihres Versands noch über SMTP (Plugin, Relay, Drittanbieter-Tool), bleibt dieser Teil betroffen.

Was ist der Unterschied zwischen primärem API-Schlüssel und Domain Sending Keys?

Der primäre API-Schlüssel (Primary Account API Key) gibt vollständigen CRUD-Zugriff auf alle Konto-APIs. Domain Sending Keys sind auf nur Versand (POST /messages) für eine bestimmte Domain beschränkt. Verwenden Sie Domain Sending Keys in Ihren Apps, um die Angriffsfläche im Falle einer Kompromittierung zu begrenzen.

Warum generiert Mailgun zwei DKIM-Selektoren (pdk1 und pdk2)?

Die zwei Selektoren ermöglichen die automatische DKIM-Schlüsselrotation alle 120 Tage ohne Serviceunterbrechung. Wenn Mailgun Schlüssel aus Sicherheitsgründen erneuern möchte, generiert es einen neuen Schlüssel auf pdk2, während pdk1 noch aktiv ist, und wechselt dann schrittweise den Verkehr. Dies vermeidet jegliche Zustellbarkeitsunterbrechung während des Schlüsselwechsels.

Muss ich ein Custom MAIL FROM wie bei Amazon SES konfigurieren?

Nein, im Gegensatz zu Amazon SES, das Custom MAIL FROM für SPF-Ausrichtung erfordert, verwendet Mailgun automatisch Ihre verifizierte Domain im Return-Path (bounce+id@mail.captaindns.com). SPF-DMARC-Ausrichtung funktioniert nativ ab Domain-Konfiguration, ohne separate Einrichtung.

Wie funktioniert der Testmodus ohne Credits zu verbrauchen?

Verwenden Sie den o:testmode=yes-Parameter (API) oder den X-Mailgun-Drop-Message: yes-Header (SMTP). Nachrichten werden akzeptiert, aber nicht zugestellt, generieren ein delivered-Event mit Code 650. Ideal zum Testen der Anfragestruktur und des Payload-Formats ohne tatsächlichen E-Mail-Versand.

Was ist das echte Limit von Empfängern pro API-Aufruf?

Maximal 1.000 Empfänger pro Aufruf (to + cc + bcc kombiniert). Darüber hinaus in mehrere Aufrufe aufteilen. Um an 10.000 Personen zu senden, benötigen Sie 10 API-Aufrufe. Verwenden Sie Empfängervariablen, um den Inhalt jedes Empfängers im selben Batch zu personalisieren.

Ist der Flex-Plan für Produktion mit variablem Volumen geeignet?

Seit der Tarifverdoppelung (2,00 $/1.000 E-Mails im Dezember 2025) ist der Flex-Plan weniger wettbewerbsfähig geworden. Für mehr als 18.000 E-Mails/Monat ist der Foundation 50k-Plan (35 $/Monat) kosteneffizienter. Flex bleibt interessant für sehr niedrige und unregelmäßige Volumen (< 10.000/Monat) oder zum Testen vor einer Verpflichtung.

Sollte ich eine dedizierte IP für mein Projekt erhalten?

Wahrscheinlich nicht. Eine dedizierte IP erfordert ein Mindestvolumen von 1 Million E-Mails pro Monat mit regelmäßigem Versand. Sie erfordert ein 15+ Tage Warmup und kostet 59 $/IP/Monat zusätzlich (oder enthalten ab Foundation 100k). Wenn Ihr Volumen niedriger ist oder Ihre Sendungen unregelmäßig sind, bleiben Sie bei gemeinsamer IP. Mailguns Reputation auf gemeinsamer IP ist ausgezeichnet.

Sind API-Rate-Limits dokumentiert?

Nein, Mailgun dokumentiert keine spezifischen Rate-Limits pro Endpunkt öffentlich, außer für die Domains-API (300 req/min). Neue Konten können vor Geschäftsverifizierung auf 100 Nachrichten/Stunde begrenzt sein. Die X-RateLimit-*-Header in Antworten zeigen Ihr Echtzeit-Kontingent an. Im Falle von 429 implementieren Sie exponentielles Backoff.

Glossar

  • REST API: Mailguns HTTP-API zum Senden von Transaktions-E-Mails. Haupt-Endpunkt: POST /v3/{domain}/messages. Authentifizierung: HTTP Basic Auth (api:YOUR_API_KEY). Empfohlene Methode für jede neue Integration.

  • SMTP Relay: Mailguns SMTP-Server (smtp.mailgun.org), der das Senden über Standard-SMTP-Protokoll ermöglicht. Authentifizierung: SASL/PLAIN (postmaster@ + SMTP-Passwort). Verfügbare Ports: 587 (STARTTLS), 465 (direktes TLS), 2525 (GCE-Fallback). Laut der Ankündigung von Mailgun vom 9. November 2026 ist ab dem 1. März 2027 TLS 1.2 oder höher erforderlich; TLS 1.0 und 1.1 werden abgewiesen.

  • Domain Verification: DNS-Konfiguration zur Authentifizierung Ihrer Domain mit Mailgun. Generiert SPF-, DKIM-, MX-Einträge. Mit Automatic Sender Security: 2 DKIM-CNAMEs (pdk1 und pdk2) für automatische Rotation alle 120 Tage, 2048-Bit-Schlüssel standardmäßig.

  • Return-Path (Envelope From): Technische Adresse für SMTP-Routing und Bounces. Mailgun verwendet automatisch Ihre Domain (bounce+id@mail.captaindns.com), was relaxed SPF-Ausrichtung für DMARC ohne separate Konfiguration ermöglicht. Großer Unterschied zu SendGrid (Subdomain em1234) und Amazon SES (Custom MAIL FROM erforderlich).

  • Automatic Sender Security: Empfohlene Option für Domain Verification. Generiert 2 DKIM-CNAMEs statt TXT, ermöglicht automatische DKIM-Schlüsselrotation alle 120 Tage und verwendet 2048-Bit-Schlüssel standardmäßig.

  • Empfängervariablen: Mechanismus zur Personalisierung des Inhalts jedes Empfängers bei Batch-Versand. Syntax: %recipient.variable% in der Nachricht, mit einem JSON, das jede E-Mail ihren Variablen zuordnet. Ermöglicht das Senden von bis zu 1.000 personalisierten Versionen in einem einzigen API-Aufruf.

  • IP-Warmup: Automatischer Hochlaufprozess für eine neue dedizierte IP. Zeitplan über 15 Schritte: von 1.000 E-Mails/Tag (Tag 1) bis volle Kapazität (Tag 15+). Das System schreitet alle 24h einen Schritt voran, wenn Limits erreicht werden. Überschüssiger Verkehr wird zu gemeinsamen IPs geleitet.

  • IP-Pools: Gruppen dedizierter IPs, die verschiedenen Flows zuweisbar sind (transaktional vs. Marketing, pro Kunde, pro Marke). Verfügbar bei Scale- und Enterprise-Plänen. Ermöglichen Reputationstrennung. Dynamische IP-Pools: Automatische Zuweisung basierend auf Reputationsgesundheit.

  • Event-Webhook: HTTP-Endpunkt, der von Mailgun bei Events aufgerufen wird (accepted, delivered, opened, clicked, bounced, complained, unsubscribed). Konfiguration: bis zu 3 URLs pro Event-Typ. Retry für 8h bei Fehler. Sicherheit: HMAC-SHA256-Signatur.

  • Handlebars: Vorlagensprache von Mailgun für gespeicherte Vorlagen. Unterstützt Variablen {{variable}}, Bedingungen {{#if}}, Schleifen {{#each}}, Helfer {{#equal}}. Limit: 100 Vorlagen pro Domain, 10 Versionen pro Vorlage. Keine Partials-Unterstützung.

  • Sandbox-Modus: Testmodus, der Anfrageformat validiert ohne tatsächlichen E-Mail-Versand. Aktivieren über o:testmode=yes (API) oder X-Mailgun-Drop-Message: yes (SMTP). Generiert ein delivered-Event mit Code 650. Verbraucht keine Credits. Limit: 5 verifizierte Empfänger.

  • Suppressions: Automatisch von Mailgun gepflegte Sperrlisten (Bounces, Complaints, Unsubscribes). Adressen werden standardmäßig unbegrenzt unterdrückt. Verwaltung über API: GET/POST/DELETE /v3/{domain}/{bounces|complaints|unsubscribes}. Allowlist: Verhindert Hinzufügen zu Bounces, überschreibt jedoch nicht Complaints/Unsubscribes.

  • Domain Sending Keys: API-Schlüssel, die auf nur Versand (POST /messages) für eine bestimmte Domain beschränkt sind. Im Gegensatz zum primären API-Schlüssel (vollständiger CRUD-Zugriff) reduzieren sie die Angriffsfläche. Empfohlen für Produktions-Apps.

  • RBAC API Keys (Scale+): API-Schlüssel mit vordefinierten Rollen: Admin (vollständiger Lese-/Schreibzugriff), Developer (vollständiger technischer Zugriff), Analyst (nur Metriken lesen), Support (Lesen + Suppressions-Verwaltung). Nur verfügbar bei Scale- und Enterprise-Plänen.

Offizielle Quellen

Ähnliche Artikel