Anleitung
E-Mails erneut senden und weiterleiten
Senden Sie eine gebouncte, fehlgeschlagene, gesperrte oder zurückgehaltene E-Mail als neue E-Mail erneut oder leiten Sie eine gesendete E-Mail an einen anderen Empfänger weiter, in der Weboberfläche oder per API.
Erneutes Senden verschickt eine E-Mail noch einmal mit demselben Inhalt, nachdem sie gebounct, fehlgeschlagen, gesperrt oder zurückgehalten wurde. Eine Weiterleitung sendet eine Kopie einer bereits gesendeten E-Mail an jemand anderen, zum Beispiel an eine Kollegin im Support oder an einen Kunden, der das Original verloren hat. Beides erstellt eine neue E-Mail mit eigener ID und lässt das Original unverändert.
Voraussetzungen
- In der API funktionieren beide Endpunkte mit Schlüsseln mit Full Access und Sending Only.
- Beides wird wie ein neuer Versand berechnet, Sie brauchen also genug Credits.
- Beides benötigt die ursprünglichen Nachrichteninhalte. Emailit löscht sie, wenn Ihre Aufbewahrungsdauer für Nachrichteninhalte in der Datenaufbewahrung endet:
| Pay as you go | Pro | Business | Custom | |
|---|---|---|---|---|
| Aufbewahrung der Nachrichteninhalte | 7 Tage | 30 Tage | 30 Tage | Flexibel |
E-Mail erneut senden
Eine E-Mail lässt sich erneut senden, wenn alle diese Bedingungen erfüllt sind:
| Voraussetzung | Details |
|---|---|
| Status | bounced, failed, suppressed oder held |
| Alter | Vor weniger als 30 Tagen erstellt |
| Inhalte | Die Nachrichteninhalte wurden nicht durch die Datenaufbewahrung gelöscht |
| Versanddomain | Die ursprüngliche Versanddomain existiert noch im Workspace |
Erneutes Senden erstellt eine neue E-Mail mit neuer em_-ID und neuer Message-ID. Sie verwendet die Rohnachricht, den Empfänger, die Metadaten und die Tracking-Einstellungen des Originals und durchläuft die normale Zustellung. Sie kostet 1 Credit oder 2 Credits, wenn das Original eine Kampagnen-E-Mail war. Ein Workspace im Sandbox-Modus kann nur E-Mails an Mitglieder des Workspace erneut senden.
Beheben Sie die Ursache vor dem erneuten Senden, sonst endet die neue E-Mail mit demselben Status:
- Gesperrt: Entfernen Sie die Adresse zuerst aus den Sperrungen.
- Wegen fehlender Credits zurückgehalten: Laden Sie Ihre Credits auf.
- Zurückgehalten, weil die Domain pausiert war: Beheben Sie das Problem mit der Versandgesundheit.
- Wegen des Spam-Scores zurückgehalten: Erneutes Senden verschickt denselben Inhalt und wird wahrscheinlich wieder zurückgehalten. Ändern Sie den Inhalt und senden Sie stattdessen eine neue E-Mail. Siehe Spam-Prüfungen.
- Gebounct: Prüfen Sie den Bounce-Grund auf der Detailseite der E-Mail. Ein Postfach, das nicht existiert, bounct erneut. Hat Emailit die Adresse nach dem Bounce auf Ihre Sperrliste gesetzt, entfernen Sie sie zuerst.
- Öffnen Sie Email APIEmails und dann die E-Mail.
- Wählen Sie oben auf der Seite Retry. Die Weboberfläche zeigt die Option bei zurückgehaltenen und gesperrten E-Mails; gebouncte und fehlgeschlagene E-Mails senden Sie per API erneut.
- Bestätigen Sie im Dialog Retry Email erneut mit Retry. Die neue E-Mail erscheint mit eigener ID in der Liste.
Rufen Sie E-Mail erneut senden (POST /emails/{id}/retry) mit der ID der ursprünglichen E-Mail auf. Es gibt keinen Anfrage-Body.
curl -X POST https://api.emailit.com/v2/emails/em_33VtK8mRq1xZp7LwN4cY2bHsDfa/retry \
-H "Authorization: Bearer $EMAILIT_API_KEY"const retried = await emailit.emails.retry('em_33VtK8mRq1xZp7LwN4cY2bHsDfa');retried = client.emails.retry("em_33VtK8mRq1xZp7LwN4cY2bHsDfa")$retried = $emailit->emails()->retry('em_33VtK8mRq1xZp7LwN4cY2bHsDfa');{
"object": "email",
"id": "em_33Vu2LqPz8aKd4WnX6cR1tYbHgs",
"original_id": "em_33VtK8mRq1xZp7LwN4cY2bHsDfa",
"token": "33Vu2LqQ7mFt3XcV9bNp5KsRwEz",
"message_id": "<33Vu2LqQ7mFt3XcV9bNp5KsRwEz@acme.com>",
"from": "Acme <orders@acme.com>",
"to": "ada@example.com",
"subject": "Receipt for order 1042",
"status": "accepted",
"created_at": "2026-10-01T11:15:03.552918Z",
"message": "Email has been queued for retry"
}| Fehler | Ursache |
|---|---|
404 Email not found |
Die ID existiert in diesem Workspace nicht. |
422 Cannot retry email |
Der Status erlaubt kein erneutes Senden, die E-Mail ist älter als 30 Tage, ihre Inhalte wurden gelöscht oder ihre Versanddomain wurde gelöscht. Die message nennt den Grund. |
402 Insufficient credits |
Der Workspace kann das erneute Senden nicht bezahlen. |
403 Workspace not verified |
Der Workspace ist im Sandbox-Modus, und der Empfänger ist kein Mitglied des Workspace. |
E-Mail weiterleiten
Eine Weiterleitung sendet eine ausgehende E-Mail, die Sie bereits gesendet haben, an einen neuen Empfänger. Eingehende E-Mails lassen sich nicht weiterleiten.
Standardmäßig ist die Weiterleitung ein einfaches erneutes Senden: Der Empfänger erhält Betreff, Inhalt und Anhänge des Originals, als wäre die E-Mail an ihn gesendet worden. Setzen Sie include_headers, um stattdessen eine klassische Weiterleitung zu senden, mit einem Block „Forwarded message“ (ursprünglicher From, Date, Subject und To) und einem optionalen Kommentar darüber. Der Betreff beginnt dann mit Fwd:.
tostring | string[]erforderlichto beim Senden.include_headersbooleanStandardwert: falseFwd: hinzu.commentstringinclude_headers true ist. body wird als Alias akzeptiert.htmlstringcomment verwendet wird, wenn include_headers true ist.textstringcomment im Textteil ersetzt, wenn include_headers true ist.fromstringsubjectstringinclude_headers Fwd: plus der ursprüngliche Betreff.Eine Weiterleitung ist ein neuer Versand und folgt daher denselben Regeln wie POST /emails: Credits pro Empfänger, Rate Limits für den Versand, die Prüfungen der From-Domain und der Header Idempotency-Key gelten alle. Das Tracking folgt den Einstellungen der Versanddomain. Eigene Header und Metadaten des Originals werden nicht kopiert, und Anhänge werden nur übernommen, wenn ihr Dateityp erlaubt ist.
Jeder Workspace kann 3 Weiterleitungsanfragen pro Stunde stellen, Weiterleitungen aus der Weboberfläche und per API zusammengezählt. Über dem Limit gibt die API 429 mit too_many_requests zurück.
- Öffnen Sie Email APIEmails und dann die E-Mail.
- Wählen Sie Forward.
- Geben Sie den Empfänger in To ein.
- Optional: Aktivieren Sie Add forwarded headers and a comment und schreiben Sie einen Comment.
- Wählen Sie Forward. Die neue E-Mail erscheint mit eigener ID in der Liste.
Rufen Sie E-Mail weiterleiten (POST /emails/{id}/forward) auf.
curl https://api.emailit.com/v2/emails/em_33VtK8mRq1xZp7LwN4cY2bHsDfa/forward \
-H "Authorization: Bearer $EMAILIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "support@acme.com",
"include_headers": true,
"comment": "Customer says this receipt never arrived. Can you check?"
}'const forwarded = await emailit.emails.forward('em_33VtK8mRq1xZp7LwN4cY2bHsDfa', {
to: 'support@acme.com',
include_headers: true,
comment: 'Customer says this receipt never arrived. Can you check?',
});forwarded = client.emails.forward("em_33VtK8mRq1xZp7LwN4cY2bHsDfa", {
"to": "support@acme.com",
"include_headers": True,
"comment": "Customer says this receipt never arrived. Can you check?",
})$forwarded = $emailit->emails()->forward('em_33VtK8mRq1xZp7LwN4cY2bHsDfa', [
'to' => 'support@acme.com',
'include_headers' => true,
'comment' => 'Customer says this receipt never arrived. Can you check?',
]);Die Antwort entspricht der Antwort auf einen Versand, ergänzt um original_id und die Meldung „Email has been queued for forwarding“. Die Weiterleitung schlägt mit 422 Cannot forward email fehl, wenn das Original eine eingehende E-Mail ist oder seine Inhalte gelöscht wurden.