Skip to content

email.bounced

Sent when email bounces (hard or soft).

{
  "event_id": "email.bounced:550e8400-e29b-41d4-a716-446655440000",
  "event": "email.bounced",
  "timestamp": "2025-12-27T12:34:58.234Z",
  "email_id": "550e8400-e29b-41d4-a716-446655440000",
  "recipient": "invalid@example.com",
  "bounce_type": "hard",
  "bounce_category": "invalid_recipient",
  "suppressed": true,
  "reason": "User unknown",
  "diagnostic_code": "550 5.1.1",
  "tag": "campaign-welcome",
  "metadata": {
    "campaign_id": "welcome-2025",
    "customer_segment": "new-users"
  }
}

Notes:

  • bounce_category sub-classifies the bounce: invalid_recipient, mailbox_full, policy_block, reputation_block, spam_block, content_block, dns_failure, transient_failure, or unknown.
  • suppressed indicates whether the recipient was added to the suppression list. Only invalid_recipient bounces (and complaints) suppress permanently — policy/reputation/spam/mailbox-full blocks are recorded but do not suppress, since they are sender-side or transient signals.
  • tag and metadata fields are included if provided when sending the email.