Webhooks

Event: domain.ready (rolling out)

(rolling out) Sent when a domain finishes provisioning — DNS is verified and the domain is ready for mailboxes and sending.

postWebhookdomain.ready

Payload

idstring

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

object'event'
type'domain.ready'

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.