Event reference

All webhook payloads share this envelope:

{
  "id": "<event-id>",
  "type": "domain.verified",
  "createdAt": "2026-05-05T11:39:19.406Z",
  "data": { ... }
}

The data shape is event-specific.

Event types

Type	Fires when
domain.created	POST /v1/domains succeeds (status pending).
domain.verified	DNS first points at our edge.
domain.failed	Pending domain stays unresolvable, or cert issuance fails irrecoverably.
domain.expired	DNS stops pointing at us, or cert window elapsed.
domain.monitor_updated	Any runtime monitor signal change (noisier).
domain.deleted	DELETE /v1/domains/{id} succeeds.

Subscribing to a subset

When you create the endpoint, pass an explicit list of event types in events:

{
  "url": "https://your-app.com/webhooks/domainee",
  "events": ["domain.verified", "domain.failed", "domain.expired"]
}

An empty events: [] subscribes to all events.

If you only care about lifecycle transitions, subscribe to domain.verified / domain.failed / domain.expired and skip monitor_updated.

See the Webhooks guide for delivery format, signature verification, and retry behavior.