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

⚡TL;DR

• Mailjet (Sinch) verarbeitet 300+ Milliarden E-Mails/Jahr mit einer modernen API v3.1, die auf 50 Nachrichten pro Aufruf begrenzt ist.
• DKIM ist Pflicht: Selektor mailjet, standardmäßig 2048-Bit-Schlüssel seit April 2024, 4096 Bit verfügbar.
• Das SPF-Alignment schlägt standardmäßig fehl (Return-Path auf Mailjet-Domain): Verlassen Sie sich allein auf DKIM für DMARC.
• Dedizierte IP ab Premium 100k Plan (95$/Monat) inklusive, mit obligatorischem Warm-up von 2-6 Wochen.
• Free-Plan: 6.000 E-Mails/Monat, aber begrenzt auf 200/Tag, ideal für Dev/Staging.

Einleitung

Mailjet hat sich als wichtiger Akteur im Bereich Transaktions-E-Mails in Europa etabliert. Das Unternehmen wurde 2010 in Nantes gegründet, bevor es im Dezember 2021 von Sinch für 1,9 Milliarden Dollar übernommen wurde. Heute verarbeitet die Plattform mehr als 300 Milliarden E-Mails pro Jahr und bedient über 100.000 zahlende Kunden in mehr als 150 Ländern.

Hinter der Marketing-Oberfläche und dem Drag-and-Drop-Editor verbergen sich jedoch kritische technische Feinheiten: Unterschiede zwischen API v3 und v3.1, DKIM-Konfiguration mit Schlüsselgrößenauswahl, standardmäßig fehlschlagendes DMARC-Alignment bei SPF, strenge Einschränkungen des Free-Plans (nur 200 E-Mails/Tag) und Einschränkungen bei dedizierter IP mit obligatorischem Warm-up.

Dieser Leitfaden richtet sich an Entwickler, DevOps und Systemadministratoren, die Mailjet für Transaktions-E-Mails integrieren. Wir beschreiben die Stolpersteine, die kritischen Konfigurationen und die technischen Entscheidungen je nach Ihrem Stack und Ihren Volumina.

Mailjet im Sinch-Ökosystem

Geschichte und Akquisitionen

Mailjet wurde 2010 in Nantes von Wilfried Durand und Julien Tartarin über eFounders (heute Hexa) gegründet. Die Akquisitionshistorie:

Datum	Ereignis
Februar 2011	Öffentlicher Launch
Oktober 2019	Übernahme durch Mailgun (Thoma Bravo)
Dezember 2021	Übernahme durch Sinch für 1,9 Mrd. $
2025	300+ Milliarden E-Mails/Jahr

Positionierung vs. Mailgun

Innerhalb des Sinch-Ökosystems ist die Differenzierung klar:

Plattform	Zielgruppe	Stärke
Sinch Mailjet	Marketer, KMU	Intuitive Oberfläche, kollaborativer Editor
Sinch Mailgun	Entwickler	API-first, 20+ APIs, fortschrittliche SDKs
Sinch Email on Acid	E-Mail-QA	Test und Cross-Client-Vorschau

Schlüsselzahl: Während des Black Friday 2025 haben Mailjet und Mailgun 20,4 Milliarden E-Mails im November zugestellt (+32% YoY).

REST-API: v3 vs. v3.1

Mailjet bietet zwei Versionen seiner Send API an. Die v3.1 wird für neue Projekte empfohlen.

Wesentliche Unterschiede

Merkmal	v3	v3.1 (empfohlen)
Endpoint	POST /v3/send	POST /v3.1/send
Payload-Struktur	Recipients Array	Messages Array erforderlich
Eigenschaftsbenennung	Bindestriche (Html-part)	CamelCase (HTMLPart)
Nachrichten pro Aufruf	100	50
Variablen	Vars	Variables
Templates	Mj-TemplateID	TemplateID
Antwort	Einfacher Status	Detailliert mit MessageUUID, MessageHref

v3.1 Request-Struktur

{
  "Messages": [{
    "From": {"Email": "sender@captaindns.com", "Name": "Absender"},
    "To": [{"Email": "dest@captaindns.com", "Name": "Empfänger"}],
    "Subject": "Bestellbestätigung {{var:order_id}}",
    "HTMLPart": "<h1>Danke {{var:firstname}}</h1>",
    "Variables": {"firstname": "Hans", "order_id": "12345"},
    "TemplateID": 12345,
    "TemplateLanguage": true
  }]
}

API-Authentifizierung

Die Authentifizierung verwendet Basic Auth mit:

• Username: API Key (öffentlich)
• Password: Secret Key (privat)

curl -X POST https://api.mailjet.com/v3.1/send \
  -u "$API_KEY:$SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"Messages": [...]}'

Empfehlung: Erneuern Sie den Secret Key alle 90 Tage.

Offizielle SDKs

Sprache	Paket	Installation
PHP	mailjet-apiv3-php	composer require mailjet/mailjet-apiv3-php
Node.js	node-mailjet	npm install node-mailjet
Python	mailjet-rest	pip install mailjet-rest
Go	mailjet-apiv3-go	go get github.com/mailjet/mailjet-apiv3-go/v4
Java	mailjet-client	Maven com.mailjet:mailjet-client:6.0.0
Ruby	mailjet-gem	gem install mailjet
C#/.NET	Mailjet.Api	NuGet Mailjet.Api

Wichtige Einschränkung: Mailjet unterstützt nicht den Parameter send_at für Transaktions-E-Mails. Scheduling ist nur für Marketing-Kampagnen über /campaigndraft verfügbar.

SMTP-Relay

Das SMTP-Relay bleibt relevant für bestehende Infrastrukturen und Legacy-CMS.

Konfiguration

SMTP-Server: in-v3.mailjet.com
Ports: 25 (STARTTLS), 465 (SSL/TLS), 587 (empfohlen), 2525 (alternativ)
Username: [API Key]
Password: [Secret Key]
Verschlüsselung: TLS auf allen Ports unterstützt

X-Mailjet-* Header für erweiterte Funktionen

Header	Verwendung
X-MJ-CustomID	Benutzerdefinierte ID für Tracking
X-MJ-EventPayload	Payload, der in Webhooks zurückgegeben wird
X-MJ-Campaign	Nachrichtengruppierung
X-MJ-TemplateID	Mailjet Template-ID
X-MJ-TemplateLanguage	Aktiviert die Template-Engine (true)
X-MJ-Vars	JSON-Variablen für Personalisierung
X-MJ-TrackOpen / X-MJ-TrackClick	Tracking überschreiben (0/1)

SMTP vs. API: Wann was wählen?

Wählen Sie SMTP, wenn:

• Bestehende Infrastruktur (Postfix, Sendmail)
• CMS ohne SDK (Legacy WordPress, Drupal)
• Systeme ohne native HTTP-Fähigkeit

Wählen Sie API, wenn:

• Neue Entwicklungen
• Bedarf an sofortigen Antworten (MessageUUID)
• Erweiterte Personalisierung (Templates, Variablen)
• Feine Fehlerbehandlung

DKIM-Konfiguration: Der kritische Punkt

Warum DKIM obligatorisch ist

Seit den Gmail/Yahoo-Anforderungen vom Februar 2024 ist die DKIM-Authentifizierung unverzichtbar. Ohne konfiguriertes DKIM riskieren Ihre E-Mails den Spam-Ordner oder die Ablehnung.

Konfigurationsprozess

1. Account Settings → Domains & Sender addresses → SPF/DKIM Authentication
2. Domain hinzufügen, falls nicht aufgelistet
3. Auf Setup SPF/DKIM Authentication klicken
4. Die bereitgestellten DKIM-Werte kopieren
5. Den TXT-Eintrag in Ihrem DNS erstellen
6. Auf Refresh klicken zur Verifizierung

Mailjet DKIM-Parameter

Parameter	Wert
Selektor	mailjet
DNS-Hostname	mailjet._domainkey.captaindns.com
Typ	TXT (nicht CNAME)

Verfügbare Schlüsselgrößen

Größe	Status	Empfehlung
1024 Bit	Legacy	Maximale Kompatibilität
2048 Bit	Standard seit April 2024	Empfohlen
4096 Bit	Verfügbar (neue Konten)	Maximale Sicherheit

Beispiel DKIM-Eintrag:

Typ: TXT
Host: mailjet._domainkey
Wert: k=rsa; p=MIGfMA0GCSqGSIb3DQEBA...[öffentlicher Schlüssel]...QIDAQAB
TTL: 300

Schlüsselrotation: Verfügbar über Account → Domains → Regenerate Key. Erfordert DNS-Aktualisierung nach Regenerierung.

SPF-, DKIM- und DMARC-Alignment

Das Problem mit dem SPF-Alignment

Standardmäßig verwendet Mailjet seine eigene Domain für den Return-Path (bnc3.mailjet.com). Folge: Das SPF-Alignment schlägt systematisch für DMARC fehl.

Wie DMARC mit Mailjet funktioniert

Methode	Authentifizierte Domain	From-Domain	Alignment?	DMARC-Ergebnis
SPF	mailjet.com (Return-Path)	captaindns.com	Nein	Trägt nicht bei
DKIM	captaindns.com (Signatur d=)	captaindns.com	Ja	DMARC bestanden

Strategie: Verlassen Sie sich für die DMARC-Konformität allein auf DKIM. Ein einziger alignierter Mechanismus reicht aus.

SPF-Alignment aktivieren (optional, zahlende Konten)

Wenn Sie das SPF-Alignment wünschen (doppelte DMARC-Validierung):

1. Einen CNAME erstellen: bnc3.captaindns.com CNAME bnc3.mailjet.com
2. Ein Support-Ticket bei Mailjet mit DNS-Screenshot und API-Key einreichen
3. Mailjet aktiviert den benutzerdefinierten Return-Path (begrenzt auf einen pro API-Key)

Hinweis: Diese Konfiguration ist zahlenden Konten vorbehalten und erfordert einen Support-Eingriff.

Empfohlene DMARC-Konfiguration

# Phase 1 - Monitoring
_dmarc TXT "v=DMARC1; p=none; rua=mailto:dmarc@captaindns.com"

# Phase 2 - Quarantäne
_dmarc TXT "v=DMARC1; p=quarantine; pct=100; rua=mailto:dmarc@captaindns.com"

# Phase 3 - Ablehnung
_dmarc TXT "v=DMARC1; p=reject; pct=100; rua=mailto:dmarc@captaindns.com"

Dedizierte vs. geteilte IP

Schwellenwerte für dedizierte IP

Kriterium	Schwellenwert
Absolutes Minimum	100.000 E-Mails/Monat
ISP-Empfehlung	150.000 E-Mails/Monat + 5.000/Tag
Kostenlos inklusive	Premium 100k+ und Custom Pläne

Warm-up-Prozess

Eine neue dedizierte IP erfordert einen obligatorischen Warm-up:

Parameter	Wert
Typ	Manuell, vom Mailjet-Deliverability-Team begleitet
Start	~300 E-Mails Tag 1
Progression	+20% pro Tag
Dauer	2-6 Wochen je nach Volumen und Engagement
Kontakt	Support/Sales obligatorisch (kein Self-Service)

Wann bei geteilter IP bleiben?

Bleiben Sie bei geteilter IP, wenn:

• Volumen unter 100.000 E-Mails/Monat
• Unregelmäßige oder sporadische Versendungen
• Reiner Transaktionsverkehr mit geringem Volumen
• Keine Ressourcen für Warm-up-Management

Wechseln Sie zu dedizierter IP, wenn:

• Regelmäßiges Volumen über 150.000 E-Mails/Monat
• Bedarf, Marketing- und Transaktionsverkehr zu trennen
• Whitelisting- oder Compliance-Anforderungen
• Ressourcen zur Reputationsüberwachung

Preise 2025

Verfügbare Pläne

Plan	Preis/Monat	E-Mails/Monat	E-Mails/Tag	Dedizierte IP
Free	0$	6.000	200	Nein
Essential 15k	17$	15.000	Unbegrenzt	Nein
Premium 15k	27$	15.000	Unbegrenzt	Nein
Premium 100k	95$	100.000	Unbegrenzt	Inklusive
Premium 500k	470$	500.000	Unbegrenzt	Inklusive
Custom	Angebot	Individuell	Unbegrenzt	Inklusive

Jährlicher Rabatt: 10% auf alle Pläne.

Funktionen nach Plan

Funktion	Free	Essential	Premium
APIs, SMTP, Webhooks	Ja	Ja	Ja
Mailjet-Logo	Vorhanden	Entfernt	Entfernt
Segmentierung	Nein	Ja	Ja
Automation	Nein	Nein	Ja
A/B-Testing	Nein	Nein	Ja (10 Versionen)
Multi-User	Nein	Nein	Ja
Dedizierte IP	Nein	Nein	Ja (100k+)
SSO	Nein	Nein	Ja (100k+)

Zusätzliche Kosten

• Überschreitung: 2,24$/1000 (niedrige Stufen), 1,04$/1000 (hohe Stufen)
• E-Mail-Validierungen: 500/Monat (Essential), 2.000/Monat (Premium 100k+)
• Nonprofit-Rabatt: 20% auf monatliche Pläne
• Keine Guthabenübertragung: Nicht genutzte E-Mails verfallen am Ende des Zyklus

Technische Limits

Rate Limits

Element	Limit
Test-Mode-Konten	10 E-Mails/Stunde
Free-Plan	200 E-Mails/Tag
SMS-API	6 Anfragen/Sekunde
Dedizierte IP	~100.000 E-Mails/Stunde
Nachrichten v3 pro Aufruf	100
Nachrichten v3.1 pro Aufruf	50

Throttling: HTTP-Code 429 Too Many Requests mit Fehler MJ-002: Exceeded API Rate Limit.

Plattform-Quotas

Element	Limit
Maximale E-Mail-Größe	15 MB
Empfänger pro Aufruf (v3)	50
Message-Objekte pro Payload (v3.1)	100
HTML-Größe (vor Gmail-Clipping)	102 KB
Bild-Upload	2 MB (empfohlen unter 200 KB)
Kontakte Free-Plan	1.000

Bounce-Management

Typ	Mailjet-Verhalten
Hard Bounce	Automatische Sperrung 90 Tage
Soft Bounce	Retry für 24h, dann als Soft-Bounced markiert
Spam-Beschwerde	Systematische Sperrung via FBL
Abmeldung	Automatische Entfernung aus Listen

Webhooks und Event API

Verfügbare Ereignisse

Ereignis	Beschreibung
sent	E-Mail vom Ziel-SMTP-Server akzeptiert
delivered	Zustellung bestätigt
open	Öffnung erkannt
click	Klick auf Link
bounce	Rückläufer (Hard oder Soft)
blocked	Von Mailjet vorblockiert
spam	Als Spam markiert
unsub	Abmeldung

Webhook-Konfiguration

POST /v3/REST/eventcallbackurl
{
  "EventType": "open",
  "Url": "https://captaindns.com/webhook",
  "Version": 2
}

Retry-Logik: Versuche alle 30 Sekunden für 24h bei Nicht-200. URL wird nach wiederholten Fehlern ausgesetzt.

Sicherheit: HTTPS mit Basic Auth empfohlen (https://user:pass@captaindns.com/webhook).

Template-Sprache

Mailjet verwendet eine Jinja2/Twig-ähnliche Syntax:

Variablen

Mailjet bietet vier Arten von Variablen:

• API-Variable: Syntax var:name für über die API übergebene Daten
• Standardwert: Syntax var:name:"default" wenn die Variable fehlt
• Kontaktdaten: Syntax data:property für persistente Kontakteigenschaften
• Vordefinierte Variable: Syntax mj:contact.email für Systemdaten

Bedingungen und Schleifen

Bedingung:
{% if var:totalorders > "5" %}
VIP-Promo-Code: -10%
{% else %}
Willkommen neuer Kunde!
{% endif %}

Schleife:
{% for item in var:products %}
Produkt: item.name - item.price EUR
{% endfor %}

Compliance und Zertifizierungen

Zertifizierung	Status
ISO 27001	Ja (erster reiner ESP zertifiziert, 2017)
ISO 27701	Ja (Datenschutz-Erweiterung)
SOC 2 Type II	Ja (~400 Kontrollen)
PCI DSS	Ja
HIPAA	Auf Anfrage
DSGVO	Erstes AFAQ DSGVO-zertifiziertes Unternehmen (2018)

Daten: Ausschließliche Speicherung in der EU (Google Cloud Platform).

Kontosicherheit:

• Zwei-Faktor-Authentifizierung (2FA) über TOTP-Apps (Google Authenticator, Authy)
• SSO und SAML auf Premium 100k+ Plänen (Okta, Azure AD, Auth0)
• Login-Challenge für unbekannte IPs (seit März 2024)

Aktionsplan: Einrichtung in 7 Schritten

1. Konto erstellen und Zugangsdaten generieren

• Ein Mailjet-Konto erstellen (Free möglich)
• API Key + Secret Key in Account Settings → API Key Management generieren
• Beide notieren: API Key (öffentlich) und Secret Key (privat, zu schützen)

2. Absender hinzufügen und validieren

• Einen Absender in Account Settings → Senders & Domains erstellen
• Die Adresse über den per E-Mail erhaltenen Link validieren

3. DKIM konfigurieren (obligatorisch)

• Zu Domains & Sender addresses → SPF/DKIM Authentication gehen
• Die von Mailjet generierten DKIM-Werte kopieren
• Den TXT-Eintrag bei Ihrem Registrar erstellen:
  • Name: mailjet._domainkey
  • Wert: der bereitgestellte öffentliche Schlüssel
• Auf Propagierung warten (max. 24-48h)
• Auf Refresh klicken zur Verifizierung

4. SPF konfigurieren (optional)

Wenn Sie den SPF-Include wünschen:

v=spf1 include:spf.mailjet.com ~all

Hinweis: Der SPF-Include allein reicht nicht für das DMARC-Alignment (siehe Abschnitt Alignment).

5. Versandmethode wählen

Option A: REST API v3.1

• Den Endpoint POST /v3.1/send implementieren
• SDKs verwenden, wenn für Ihren Stack verfügbar
• Templates bei Bedarf in Templates erstellen

Option B: SMTP-Relay

• Ihre App konfigurieren mit:
  • Host: in-v3.mailjet.com
  • Port: 587 (STARTTLS)
  • User: API Key
  • Password: Secret Key

6. Webhooks konfigurieren

• Account Settings → Event tracking (Webhooks)
• Endpoints erstellen für: delivered, bounced, opened, clicked, spam
• Mit HTTPS + Basic Auth absichern

7. Testen und überwachen

• Eine Test-E-Mail senden
• In Stats prüfen, ob der Versand OK ist
• Die Header der empfangenen E-Mail prüfen (DKIM pass, korrekter From-Domain)
• Das Dashboard für Metriken überwachen

FAQ

Was ist der Unterschied zwischen API v3 und v3.1?

Die v3.1 verwendet CamelCase-Eigenschaftsnamen (HTMLPart) vs. Bindestriche (Html-part), begrenzt Nachrichten auf 50 pro Aufruf (vs. 100) und gibt detailliertere Antworten mit MessageUUID und MessageHref zurück. Die v3.1 wird für neue Projekte empfohlen.

Warum schlägt das SPF-Alignment bei Mailjet fehl?

Mailjet verwendet seine eigene Domain für den Return-Path (bnc3.mailjet.com). DMARC prüft das Alignment zwischen der durch SPF authentifizierten Domain und der From-Domain. Da diese Domains unterschiedlich sind, trägt SPF nicht zu DMARC bei. Lösung: Verlassen Sie sich allein auf DKIM, das das Alignment besteht.

Muss ich include:spf.mailjet.com zu meinem SPF hinzufügen?

Das ist nicht obligatorisch und ändert nichts am DMARC-Alignment. Der SPF-Include kann für die grundlegende SPF-Validierung nützlich sein, aber DKIM allein reicht aus, um DMARC bei Mailjet zu bestehen. Das SPF-Alignment ist nur mit einem benutzerdefinierten Return-Path möglich (zahlende Konten, Support erforderlich).

Reicht der Free-Plan für eine Produktions-App?

Ja, wenn Ihr Volumen 200 E-Mails/Tag nicht überschreitet (Achtung: Der Free-Plan bietet 6.000/Monat, aber begrenzt auf 200/Tag). Alle Transaktionsfunktionen (API, SMTP, Webhooks) sind verfügbar. Ideal für MVP, Staging oder Apps mit sehr geringem Volumen.

Welche DKIM-Schlüsselgröße sollte ich wählen?

2048 Bit ist seit April 2024 Standard und eignet sich für die meisten Fälle. 4096 Bit ist für neue Konten verfügbar, wenn Sie maximale Sicherheit wünschen. 1024 Bit ist Legacy und nicht empfohlen, außer bei spezifischen Kompatibilitätsanforderungen.

Wann brauche ich eine dedizierte IP?

Wenn Sie regelmäßig mehr als 100.000 E-Mails/Monat versenden, wenn Sie die Reputation Ihres Transaktionsverkehrs isolieren müssen oder wenn Sie Whitelisting-Anforderungen haben. Die dedizierte IP ist in den Premium 100k+ Plänen enthalten und erfordert ein Warm-up von 2-6 Wochen.

Wie funktioniert das Warm-up einer dedizierten IP?

Das Warm-up ist ein manueller Prozess, der vom Mailjet-Team begleitet wird. Es beginnt mit etwa 300 E-Mails/Tag und steigt um 20% pro Tag über 2 bis 6 Wochen. Es ist erforderlich, täglich zu senden, um die Reputation aufzubauen. Kontakt zu Support/Sales ist für die Aktivierung obligatorisch.

Kann ich den Versand von Transaktions-E-Mails zu einem bestimmten Zeitpunkt planen?

Nein, Mailjet unterstützt den Parameter send_at für Transaktions-E-Mails über die Send API nicht. Scheduling ist nur für Marketing-Kampagnen über den Endpoint /campaigndraft verfügbar. Für Transaktions-E-Mails müssen Sie das Scheduling auf Anwendungsseite verwalten.

Glossar

• SPF (Sender Policy Framework): Authentifizierungsprotokoll, das die autorisierten Server für den E-Mail-Versand einer Domain auflistet. SPF authentifiziert die Return-Path-Domain. Bei Mailjet ist der Include spf.mailjet.com.

• DKIM (DomainKeys Identified Mail): Authentifizierungsprotokoll, das E-Mails kryptografisch signiert. Mailjet verwendet den Selektor mailjet und bietet Schlüssel von 1024 bis 4096 Bit.

• DMARC (Domain-based Message Authentication, Reporting & Conformance): Protokoll, das das Alignment zwischen SPF/DKIM und dem From-Header prüft. Bei Mailjet besteht standardmäßig nur DKIM das Alignment.

• Return-Path (Envelope From): Technische Adresse zum Routen der E-Mail und zur Bounce-Verwaltung. Bei Mailjet ist dies standardmäßig bnc3.mailjet.com, was das SPF-Alignment verhindert.

• DMARC-Alignment: Prüfung, ob die authentifizierte Domain (SPF oder DKIM) mit der From-Domain übereinstimmt. Der Relaxed-Modus (Standard) akzeptiert Subdomains.

• API Key: Öffentlicher Mailjet-Identifier, der als Benutzername für die API- und SMTP-Authentifizierung verwendet wird.

• Secret Key: Privater Mailjet-Schlüssel, der als Passwort verwendet wird. Alle 90 Tage zu erneuern.

• Send API: Mailjet E-Mail-Versand-Endpoint. Version v3.1 empfohlen (POST /v3.1/send).

• Rate Limit: Durchsatzbegrenzung. HTTP-Code 429 bei Überschreitung. v3.1-Nachrichten auf 50 pro Aufruf begrenzt.

• Warm-up: Prozess der progressiven Volumensteigerung einer dedizierten IP. 2-6 Wochen bei Mailjet.

• Webhook: HTTP-URL, die von Mailjet bei Ereignissen aufgerufen wird (delivered, bounced, etc.). Retry für 24h bei Fehlern.

Offizielle Quellen

• Mailjet API-Dokumentation
• Mailjet DKIM-Konfiguration
• Mailjet Preise 2025
• Pathwire-Übernahme durch Sinch
• Gmail/Yahoo-Anforderungen Februar 2024