Événement webhook · Livraison

return_path

Envoyé lorsqu'un message de bounce (DSN) arrive plus tard, après que le serveur de destination a d'abord accepté l'e-mail. Un échec fait passer l'e-mail à bounced. Un avis de retard ou de livraison envoie seulement cet événement.

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

// Bounce message received
{
  "event": "return_path",
  "timestamp": "2026-10-23T04:40:02.000Z",
  "data": {
    "recipientEmail": "john.doe@example.com",
    "fromAddress": "noreply@yourdomain.com",
    "reason": "550 5.1.1 The email account that you tried to reach does not exist",
    "trackingId": "7c4f2d9b-1a8e-4305-9b1e-6d2a0f7c3e81"
  }
}
!

Pas de emailId au premier niveau. Le message de bounce ne contient que notre ID de suivi, cet événement arrive donc sans emailId. Utilisez data.trackingId et data.recipientEmail pour le rapprocher.

i

Ce qu'il advient de l'adresse. Si l'adresse n'existe pas, elle est placée sur la liste des hard bounces pendant 90 jours et les envois suivants vers elle sont supprimés. Une boîte pleine compte comme un soft bounce, et après 3 d'affilée l'adresse est traitée comme un hard bounce. Les blocages pour politique ou réputation (5.7.x) ne marquent pas l'adresse. Un avis indiquant que l'e-mail est retardé ou a été livré laisse le statut de l'e-mail inchangé.

Événement bounced →

Référence des champs

  • event

    Valeur fixe : "return_path".

  • timestamp

    Date de traitement du message de bounce (ISO 8601, UTC).

  • data.recipientEmail

    Adresse e-mail du destinataire.

  • data.fromAddress

    Adresse e-mail de l'expéditeur.

  • data.reason

    L'erreur du message de bounce (jusqu'à 300 caractères).

  • data.trackingId

    Identifiant de l'e-mail d'origine, issu de l'adresse de bounce.