email.bounced
Event triggered whenever the recipient's mail server permanently rejected the email.
Response Body Parameters
Section titled “Response Body Parameters”All webhook payloads follow a consistent top-level structure with
event-specific data nested within the data object.
-
type(string) — The event type that triggered the webhook (e.g.,email.bounced). -
created_at(string) — ISO 8601 timestamp when the webhook event was created. -
data(object) — Event-specific data containing detailed information about the event. The data object for theemail.bouncedevent contains the following parameters:
object parameters
broadcast_id(string) — Unique identifier for the broadcast campaign (if applicable)created_at(string) — ISO 8601 timestamp when the email was createdemail_id(string) — Unique identifier for the specific emailmessage_id(string) — RFC Message-ID header value for the emailfrom(string) — Sender's email address. For sent events, this matches the value passed at send time and may include a display name (e.g.,Name <email@domain.com>). For received events, this is the bare email address only; the display name from the originalFrom:header is preserved inheaders.fromon the retrieve endpoint.to(array) — Array of impacted recipient email addressessubject(string) — Email subject linetemplate_id(string) — Unique identifier for the template used (if applicable)tags(Record<string, string>) — Object of tag key-value pairs associated with the email.
Example:
{
"category": "welcome",
"user_id": "1234567890"
}bounce(object) — Bounce details from the receiving server
bounce object
diagnosticCode(array) — Array of SMTP diagnostic responses from the receiving server, including the status code and reason for the bounce (e.g.,smtp; 550 5.5.0 Requested action not taken: mailbox unavailable)message(string) — Detailed bounce message from the receiving serversubType(string) — Bounce sub-type (e.g.,Suppressed,MessageRejected)type(string) — Bounce type (e.g.,Permanent,Temporary)Learn more about bounce types and subtypes.
{
"type": "email.bounced",
"created_at": "2026-11-22T23:41:12.126Z",
"data": {
"broadcast_id": "8b146471-e88e-4322-86af-016cd36fd216",
"created_at": "2026-11-22T23:41:11.894Z",
"email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
"message_id": "<111-222-333@email.example.com>",
"from": "Acme <onboarding@resend.dev>",
"to": ["delivered@resend.dev"],
"subject": "Sending this example",
"template_id": "43f68331-0622-4e15-8202-246a0388854b",
"bounce": {
"message": "The recipient's email address is on the suppression list because it has a recent history of producing hard bounces.",
"subType": "Suppressed",
"type": "Permanent"
},
"tags": {
"category": "confirm_email"
}
}
}