email.bounced

Event triggered whenever the recipient’s mail server permanently rejected the email.

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 the email.bounced event contains the following parameters:

Hide object parameters

broadcast_id

string

Unique identifier for the broadcast campaign (if applicable)

created_at

string

ISO 8601 timestamp when the email was created

email_id

string

Unique identifier for the specific email

from

string

Sender email address and name in the format “Name <[email protected]>”

array

Array of impacted recipient email addresses

subject

string

Email subject line

template_id

string

Unique identifier for the template used (if applicable)

tags

array

Array of tag objects associated with the email

Show tag object

name

string

The tag key

value

string

The tag value

bounce

object

Bounce details from the receiving server

Hide 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 server

subType

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": "2024-11-22T23:41:12.126Z",
  "data": {
    "broadcast_id": "8b146471-e88e-4322-86af-016cd36fd216",
    "created_at": "2024-11-22T23:41:11.894719+00:00",
    "email_id": "56761188-7520-42d8-8898-ff6fc54ce618",
    "from": "Acme <[email protected]>",
    "to": ["[email protected]"],
    "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"
    }
  }
}

Getting Started

Emails

Domains

Contacts

Response Body Parameters