Webhook-Event · Zustellung
failed
Wird gesendet, wenn wir eine E-Mail aufgeben, nachdem ihre Wiederholungen aufgebraucht sind.
Wird als signierter POST an Ihre Webhook-URL gesendet. Unter Einrichtung & Events erfahren Sie, wie Sie die Signatur prüfen.
Payload
// Rate-limit cycles ran out
{
"event": "failed",
"emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"timestamp": "2026-10-23T04:32:10.000Z",
"data": {
"recipientEmail": "user@example.com",
"fromAddress": "hello@yourdomain.com",
"reason": "Max retries (4) exceeded: 421 4.7.28 Our system has detected an unusual rate of mail from your IP"
}
}Sie erhalten eventuell auch bounced. Wenn bei temporären Fehlern, Verbindungsfehlern oder Greylisting die Wiederholungen aufgebraucht sind, wird die E-Mail zusätzlich als Bounce protokolliert und ein bounced-Event gesendet. Wenn die Rate-Limit-Zyklen aufgebraucht sind, wird nur failed gesendet.
Steuern Sie, wie lange wir es weiter versuchen. Legen Sie retryRateLimited, retryUnavailable und retryUnavailableSeconds pro E-Mail fest.
Zustelloptionen →Feldreferenz
eventFester Wert: "failed".
emailIdID der E-Mail, dieselbe, die POST /send zurückgibt.
timestampWann das Event eingetreten ist (ISO 8601, UTC).
data.recipientEmailE-Mail-Adresse des Empfängers.
data.fromAddressE-Mail-Adresse des Absenders.
data.reasonWarum wir aufgegeben haben. "Max retries (N) exceeded" bedeutet, dass die Rate-Limit-Zyklen aufgebraucht sind; andernfalls ist es die letzte Antwort des empfangenden Servers.
data.notSentNur vorhanden (true), wenn die E-Mail wegen Ihres Kontos nie gesendet wurde: keine Credits mehr, gesperrtes oder eingeschränktes Konto, Absenderdomain bei Spamhaus oder ohne DKIM, oder ungültiges From. Das ist kein Bounce. Das Log hat den Status not_sent und data.reason nennt den genauen Grund.