Webhook event · Delivery
bounced
Sent when an email is rejected for good: the address does not exist, the domain cannot receive mail, or we stopped trying.
Delivered as a signed POST to your webhook URL. See Setup & Events for how to verify the 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"
}
}Known hard bounces. An address that hard bounced in the last 90 days is not contacted again, and you get this event with a reason that starts with "Suppressed —". With the Hard Bounce Shield the email is logged as Suppressed instead and does not count as a bounce. You still get this event, with data.suppressed: true, so every queued email ends with a final event.
The address exists now? Send that email with ignoreHardBounce: true and it goes out normally.
Delivery options →Field reference
eventFixed value: "bounced".
emailIdID of the email, the same one returned by POST /send.
timestampWhen the event happened (ISO 8601, UTC).
data.recipientEmailRecipient email address.
data.fromAddressSender email address.
data.reasonThe answer from the receiving server. Starts with "Suppressed —" when we did not send because the address hard bounced in the last 90 days.
data.suppressedOnly present, as true, when the Hard Bounce Shield stopped the email. No delivery was attempted and it does not count as a bounce. Leave it out of your bounce rate.