Webhooks

domain.created

Fires when a domain is successfully created, before its DNS records are verified.

The domain.created event fires when a domain is successfully created in your account. A new domain starts as not_started and is not yet usable for sending or receiving — you must add the DNS records in data.records and verify them.

The data.status field is an aggregated status across the domain's send and receive capabilities.

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

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 required for verification (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.