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.

i

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.

i

The address exists now? Send that email with ignoreHardBounce: true and it goes out normally.

Delivery options →

Field reference

  • event

    Fixed value: "bounced".

  • emailId

    ID of the email, the same one returned by POST /send.

  • timestamp

    When the event happened (ISO 8601, UTC).

  • data.recipientEmail

    Recipient email address.

  • data.fromAddress

    Sender email address.

  • data.reason

    The answer from the receiving server. Starts with "Suppressed —" when we did not send because the address hard bounced in the last 90 days.

  • data.suppressed

    Only 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.