Webhooks

Event: domain.dns_failed (rolling out)

(rolling out) Sent when a domain's DNS health check fails — required records are missing or wrong and sending may be affected.

postWebhookdomain.dns_failed

Payload

idstring

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

object'event'
type'domain.dns_failed'

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.