Webhooks

Event: email.received (rolling out)

(rolling out) Sent when a message arrives in one of your mailboxes.

postWebhookemail.received

Payload

idstring

Event ID (evt_...). Stable across retries — use it as an idempotency key.

object'event'
type'email.received'

Event type (e.g. message.relayed, test.ping)

api_versionstring

Payload schema version

createdstring date-time

When the event occurred (use this, not arrival order)

account_idstring

The account the event belongs to

Example payload

{
  "id": "evt_01J9XK4T8Q2M5N7P",
  "api_version": "2026-08"
}

Response

Return any 2xx status within 10 seconds to acknowledge the event.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.