Webhook-Event · Zustellung

failed

Wird gesendet, wenn wir eine E-Mail aufgeben, nachdem ihre Wiederholungen aufgebraucht sind.

i

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.

i

Steuern Sie, wie lange wir es weiter versuchen. Legen Sie retryRateLimited, retryUnavailable und retryUnavailableSeconds pro E-Mail fest.

Zustelloptionen →

Feldreferenz

  • event

    Fester Wert: "failed".

  • emailId

    ID der E-Mail, dieselbe, die POST /send zurückgibt.

  • timestamp

    Wann das Event eingetreten ist (ISO 8601, UTC).

  • data.recipientEmail

    E-Mail-Adresse des Empfängers.

  • data.fromAddress

    E-Mail-Adresse des Absenders.

  • data.reason

    Warum 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.notSent

    Nur 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.