Webhook event · Delivery

return_path

Sent when a bounce message (DSN) arrives later, after the receiving server had first accepted the email. A failure moves the email to bounced. A delay or delivery notice only sends this event.

i

Delivered as a signed POST to your webhook URL. See Setup & Events for how to verify the 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"
  }
}
!

No emailId at the top level. The bounce message only carries our tracking ID, so this event comes without emailId. Use data.trackingId and data.recipientEmail to match it.

i

What happens to the address. If the address does not exist, it goes on the hard bounce list for 90 days and later sends to it are suppressed. A full mailbox counts as a soft bounce, and after 3 in a row the address is treated as a hard bounce. Blocks for policy or reputation (5.7.x) do not mark the address. A notice that the email is delayed or was delivered keeps the email status as it is.

Bounced event →

Field reference

  • event

    Fixed value: "return_path".

  • timestamp

    When the bounce message was processed (ISO 8601, UTC).

  • data.recipientEmail

    Recipient email address.

  • data.fromAddress

    Sender email address.

  • data.reason

    The error from the bounce message (up to 300 characters).

  • data.trackingId

    Identifier of the original email, from the bounce address.