Skip to main content
WEBHOOK
email_message.bounced
{
  "id": "whev_abc123",
  "type": "email_message.bounced",
  "created_at": "2025-01-15T10:30:00Z",
  "api_version": "v1",
  "data": {
    "id": "msg_abc123",
    "inbox_id": "inbox_abc123",
    "thread_id": "thread_abc123",
    "direction": "outbound",
    "status": "bounced",
    "subject": "Re: Research findings",
    "preview": "Thanks for the update...",
    "message_id": "<msg-abc123@acme.com>",
    "from": "sender@example.com",
    "to": [
      "support@acme.com"
    ],
    "labels": [
      "sent"
    ],
    "delivery": {
      "bounce": {
        "type": "Permanent",
        "subType": "Suppressed",
        "message": "The recipient's email address is on the suppression list because it has a recent history of producing hard bounces."
      }
    },
    "created_at": "2025-01-15T10:30:00Z"
  }
}

Headers

​
X-Crevio-Hmac-SHA256
string
required

Base64-encoded HMAC-SHA256 of the raw request body, keyed with your endpoint's signing secret. Verify this before processing the event.

Body

application/json

Event payload Crevio POSTs to your endpoint.

​
id
string
required

Unique identifier for this webhook event

Example:

"whev_abc123"

​
type
enum<string>
required

The event type

Available options:
email_message.bounced
Example:

"email_message.bounced"

​
created_at
string<date-time>
required

ISO 8601 timestamp of when the event was created

Example:

"2025-01-15T10:30:00Z"

​
api_version
string
required

API version used to generate the payload

Example:

"v1"

​
data
object
required

The serialized email message for this event

Response

200

Return any 2xx status within 5 seconds to acknowledge receipt.