Die /emails-Endpunkte der API v2 sind da

Wir freuen uns, Ihnen mitzuteilen: Die E-Mail-Endpunkte sind jetzt in der API v2 verfügbar! Sie können E-Mails versenden und abrufen, geplante E-Mails ändern und ausstehende E-Mails stornieren, alles über unsere leistungsstarke REST-API.

Neue Endpunkte

E-Mail versenden

POST /v2/emails

Versenden Sie eine einzelne E-Mail an einen oder mehrere Empfänger. Der Versand-Endpunkt unterstützt:

• Mehrere Empfänger – Versand an bis zu 50 Empfänger (TO, CC, BCC zusammen)
• Vorlagen – Verwenden Sie Aliase oder IDs von Vorlagen mit Variablenersetzung über die {{variable}}-Syntax
• Anhänge – Dateien als Base64-Inhalt oder per URL einbinden
• Zeitplanung – E-Mails für eine spätere Zustellung planen, per ISO 8601, Unix-Zeitstempel oder natürlicher Sprache wie „tomorrow at 9am“
• Tracking – Die Tracking-Standards der Domain für Öffnungen und Klicks übersteuern
• Metadaten – Eigene Schlüssel-Wert-Paare anhängen, die gespeichert und mit der E-Mail zurückgegeben werden
• Idempotenz – Doppelte Versände mit dem Header Idempotency-Key verhindern

Beim Versand an mehrere Adressen erhält jeder Empfänger eine eigene, eindeutige E-Mail-ID für individuelles Tracking.

E-Mail abrufen

GET /v2/emails/{id}

Rufen Sie detaillierte Informationen zu einer bestimmten E-Mail ab, darunter:

• Aktueller Status (ausstehend, geplant, gesendet, zugestellt, gebounct, storniert)
• Unveränderte E-Mail-Header und Inhalte
• Tracking-Einstellungen
• Eigene Metadaten
• Zeitstempel für Erstellung und Aktualisierungen

Geplante E-Mail aktualisieren

POST /v2/emails/{id}

Planen Sie eine E-Mail neu, die für eine spätere Zustellung vorgesehen ist. Sie können den geplanten Zeitpunkt ändern, solange bis zum Versand noch mindestens 3 Minuten bleiben.

E-Mail stornieren

POST /v2/emails/{id}/cancel

Stornieren Sie eine geplante oder ausstehende E-Mail, bevor sie versendet wird. Bei geplanten E-Mails muss die Stornierung mindestens 3 Minuten vor der geplanten Versandzeit angefordert werden.

Rate Limits

Jede Antwort enthält Rate-Limit-Header, damit Sie Ihre Nutzung überwachen können:

• ratelimit-limit – Maximale Anfragen pro Sekunde
• ratelimit-remaining – Verbleibende Anfragen in der aktuellen Sekunde
• ratelimit-daily-limit – Maximale tägliche Anfragen
• ratelimit-daily-remaining – Verbleibende tägliche Anfragen

Dokumentation

Die vollständige Dokumentation mit Codebeispielen in Node.js, PHP, Python, Ruby, Go, Rust, Java, .NET und cURL finden Sie hier:

• E-Mail versenden
• E-Mail abrufen
• Geplante E-Mail aktualisieren
• E-Mail stornieren

Demnächst: die Vorlagen-API

Wir arbeiten an der Vorlagen-API (Templates API), mit der Sie E-Mail-Vorlagen programmatisch erstellen, aktualisieren und verwalten können. Seien Sie gespannt!

Hinweis zur Abkündigung der API v1

Wichtig: Die API v1 ist abgekündigt und funktioniert ab Ende Februar 2026 nicht mehr. Falls Sie noch die API v1 verwenden, migrieren Sie bitte so bald wie möglich auf die API v2.

Sie brauchen Hilfe bei der Migration? Werfen Sie einen Blick in die Dokumentation der API v2 oder wenden Sie sich an unser Support-Team.