Skip to documentation

Webhook events

domain.deleted

A domain was removed from the team.

When it fires

domain.deleted fires when the domain is marked deleted. For a provisioned domain, this follows its AWS removal operation. Canceling or replacing an unprovisioned claim placeholder also emits it. It does not prove that all shared regional cleanup has finished. data describes the removed domain.

Payload

json
{
  "type": "domain.deleted",
  "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"
      }
    ]
  }
}
FieldDescription
id, nameThe domain's ID and name.
statusThe domain's status, such as pending, verified, partially_verified, or failed.
created_atWhen the domain was added.
regionThe AWS region the domain sends from.
capabilitiessending and receiving, each enabled or disabled.
recordsThe 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.