Webhooks

domain.updated

Fires when a domain changes — most commonly as its verification status advances.

The domain.updated event fires when a domain is updated. The most common trigger is a change in verification status as DNS records propagate and are checked — watch data.status move toward verified. It also fires when a domain is revoked because a different account verified an overlapping domain (data.status becomes revoked).

The data.records array reflects the current per-record verification state, including any Receiving MX records once inbound is enabled.

{
  "type": "domain.updated",
  "created_at": "2026-06-17T19:32:22.980Z",
  "data": {
    "id": "d91cd9bd-1176-453e-8fc1-35364d380206",
    "name": "example.com",
    "status": "partially_verified",
    "created_at": "2026-06-26T20:21:26.347412+00:00",
    "region": "us-east-1",
    "records": [
      {
        "record": "SPF",
        "name": "send",
        "type": "MX",
        "ttl": "Auto",
        "status": "verified",
        "value": "feedback-smtp.us-east-1.amazonses.com",
        "priority": 10
      },
      {
        "record": "DKIM",
        "name": "mailblastr._domainkey",
        "value": "p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDsc4Lh8xilsngyKEgN2S84...",
        "type": "TXT",
        "status": "verified",
        "ttl": "Auto"
      },
      {
        "name": "inbound.example.com",
        "priority": 10,
        "record": "Receiving MX",
        "status": "pending",
        "ttl": "Auto",
        "type": "MX",
        "value": "inbound-smtp.us-east-1.amazonaws.com"
      }
    ]
  }
}

Payload

typestringoptional

The event type that triggered the webhook.

created_atstringoptional

ISO 8601 timestamp when the webhook event was created.

dataobjectoptional

Event-specific data. The fields below live inside this object.

data.idstringoptional

Unique identifier for the domain.

data.namestringoptional

Domain name, e.g. example.com.

data.statusstringoptional

Aggregated verification status: verified, partially_verified, partially_failed, pending, not_started, failed, or revoked (a different account verified an overlapping domain).

data.created_atstringoptional

ISO 8601 timestamp when the domain was created.

data.regionstringoptional

Region where the domain is configured, e.g. us-east-1.

data.recordsobject[]optional

DNS records and their current verification state (see below).

data.records[].recordstringoptional

Record purpose: SPF, DKIM, Receiving MX, or Tracking.

data.records[].namestringoptional

DNS record name/subdomain.

data.records[].typestringoptional

DNS record type: MX, TXT, or CNAME.

data.records[].valuestringoptional

DNS record value to be set.

data.records[].ttlstringoptional

Time to live for the DNS record.

data.records[].statusstringoptional

Verification status of this specific record.

data.records[].prioritynumberoptional

Priority value for MX records (optional).

This is one of several events MailBlastr can deliver. See the full list of webhook event types.