Événement webhook · Livraison

failed

Envoyé lorsque nous abandonnons un e-mail après épuisement de ses nouvelles tentatives.

i

Envoyé sous forme de requête POST signée vers votre URL de webhook. Consultez Configuration et événements pour savoir comment vérifier la signature.

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"
  }
}
!

Vous pouvez aussi recevoir bounced. Lorsque les erreurs temporaires, les échecs de connexion ou le greylisting épuisent les nouvelles tentatives, l'e-mail est aussi enregistré comme bounce et un événement bounced est envoyé. Lorsque les cycles de rate limit sont épuisés, seul failed est envoyé.

i

Contrôlez combien de temps nous continuons à essayer. Définissez retryRateLimited, retryUnavailable et retryUnavailableSeconds par e-mail.

Options de livraison →

Référence des champs

  • event

    Valeur fixe : "failed".

  • emailId

    ID de l'e-mail, le même que celui renvoyé par POST /send.

  • timestamp

    Date de l'événement (ISO 8601, UTC).

  • data.recipientEmail

    Adresse e-mail du destinataire.

  • data.fromAddress

    Adresse e-mail de l'expéditeur.

  • data.reason

    Pourquoi nous avons abandonné. "Max retries (N) exceeded" signifie que les cycles de rate limit sont épuisés ; sinon, c'est la dernière réponse du serveur de destination.

  • data.notSent

    Présent (true) uniquement quand l'e-mail n'a jamais été envoyé à cause de votre compte : plus de crédits, compte bloqué ou restreint, domaine d'expéditeur chez Spamhaus ou sans DKIM, ou From invalide. Ce n'est pas un rebond. Le log a le statut not_sent et data.reason donne la cause exacte.