Événement webhook · Livraison

bounced

Envoyé lorsqu'un e-mail est rejeté définitivement : l'adresse n'existe pas, le domaine ne peut pas recevoir d'e-mails ou nous avons arrêté d'essayer.

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

// Rejected by the receiving server
{
  "event": "bounced",
  "emailId": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "timestamp": "2026-10-23T04:32:10.000Z",
  "data": {
    "recipientEmail": "invalid@domain.com",
    "fromAddress": "hello@yourdomain.com",
    "reason": "550 5.1.1 The email account that you tried to reach does not exist"
  }
}
!

Hard bounces connus. Une adresse qui a fait un hard bounce au cours des 90 derniers jours n'est plus contactée, et vous recevez cet événement avec un reason qui commence par "Suppressed —". Avec le Hard Bounce Shield, l'e-mail est enregistré comme Suppressed et ne compte pas comme un bounce. Vous recevez quand même cet événement, avec data.suppressed: true, pour que chaque e-mail mis en file se termine par un événement final.

i

L'adresse existe maintenant ? Envoyez cet e-mail avec ignoreHardBounce: true et il partira normalement.

Options de livraison →

Référence des champs

  • event

    Valeur fixe : "bounced".

  • 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

    La réponse du serveur de destination. Commence par "Suppressed —" lorsque nous n'avons pas envoyé parce que l'adresse a fait un hard bounce au cours des 90 derniers jours.

  • data.suppressed

    Présent uniquement, avec la valeur true, lorsque le Hard Bounce Shield a bloqué l'e-mail. Aucune livraison n'a été tentée et cela ne compte pas comme un bounce. Excluez-le de votre taux de bounce.