Webhook events

domain.updated

A domain's status or settings changed.

When it fires

domain.updated fires when the domain's status changes, for example from pending to verified after a DNS check, and when its settings change: tracking, TLS, or the sending and receiving capabilities. It also fires when a domain claim moves the domain to your team.

Payload

json

{
  "type": "domain.updated",
  "created_at": "2026-09-29T10:00:00.000Z",
  "data": {
    "id": "YOUR_DOMAIN_ID",
    "name": "example.com",
    "status": "verified",
    "created_at": "2026-09-29T09:59:59.000Z",
    "region": "us-east-1",
    "capabilities": {
      "sending": "enabled",
      "receiving": "disabled"
    },
    "records": [
      {
        "record": "SPF",
        "name": "send.example.com",
        "type": "TXT",
        "ttl": "300",
        "status": "verified",
        "value": "v=spf1 include:amazonses.com ~all"
      }
    ]
  }
}

Field	Description
`id`, `name`	The domain's ID and name.
`status`	The domain's status, such as `pending`, `verified`, `partially_verified`, or `failed`.
`created_at`	When the domain was added.
`region`	The AWS region the domain sends from.
`capabilities`	`sending` and `receiving`, each `enabled` or `disabled`.
`records`	The DNS records to publish. Each has `record` (`DKIM`, `SPF`, `DMARC`, `MX`, `Tracking`, or `Receiving`), `name`, `type` (`CNAME`, `MX`, or `TXT`), `ttl`, `status`, `value`, and `priority` on records that have one. The DKIM records join the list once Amazon SES has issued the domain's keys.

Handle the event

Verify the signature and deduplicate by svix-id.