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.
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.
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
eventFixed value: "return_path".
timestampWhen the bounce message was processed (ISO 8601, UTC).
data.recipientEmailRecipient email address.
data.fromAddressSender email address.
data.reasonThe error from the bounce message (up to 300 characters).
data.trackingIdIdentifier of the original email, from the bounce address.