Skip to content
Docs

Sending domains created, updated or deleted.

domain.created

Sent when a sending domain is added to the workspace, for example with Create a domain. The payload includes the DNS records to publish; they all start as pending. See Add a domain.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

Event ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.

typestring

Always domain.created.

objectobject

The domain the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Domain object

idstring

Domain ID (dom_…).

objectstring

Always domain.

namestring

Domain name, for example acme.com.

tracking_keystring | null

Custom subdomain for the tracking CNAME, or null for the default go.

inbound_keystring | null

Custom subdomain for the inbound MX record, or null for the default inbound.

track_loadsboolean

Whether open tracking is on by default for emails from this domain.

track_clicksboolean

Whether click tracking is on by default for emails from this domain.

created_atstring

When the domain was added, in ISO 8601 with a UTC offset.

dns_recordsobject[]

DNS records for the domain. See DNS records.

dns_records[].requiredboolean

true for the return-path MX, SPF and DKIM records, which are needed for verification. DMARC, tracking and inbound records are optional.

dns_records[].typestring

MX, TXT or CNAME.

dns_records[].namestring

Host name of the record.

dns_records[].valuestring

Value to publish.

dns_records[].priorityinteger | null

MX priority, or null for other types.

dns_records[].ttlstring

Always auto.

dns_records[].statusstring

Result of the last DNS check: pending, ok, missing or invalid.

dns_records[].errorstring | null

Why the last check failed, or null.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.created",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": false,
    "track_clicks": false,
    "created_at": "2026-10-01T10:02:11.583000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": false,
      "track_clicks": false,
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}

domain.updated

Sent when a domain’s settings change, for example its tracking or inbound options, with Update a domain or in the dashboard. DNS checks and verification don’t send this event; use Retrieve a domain to follow the verification status.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

Event ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.

typestring

Always domain.updated.

objectobject

The domain the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Domain object

idstring

Domain ID (dom_…).

objectstring

Always domain.

namestring

Domain name, for example acme.com.

verified_atstring | null

When the domain was verified, or null if it isn’t verified.

tracking_keystring | null

Custom subdomain for the tracking CNAME, or null for the default go.

inbound_keystring | null

Custom subdomain for the inbound MX record, or null for the default inbound.

track_loadsboolean

Whether open tracking is on by default for emails from this domain.

track_clicksboolean

Whether click tracking is on by default for emails from this domain.

dns_checked_atstring | null

When Emailit last checked the DNS records.

created_atstring

When the domain was added, in ISO 8601 with a UTC offset.

dns_recordsobject[]

DNS records for the domain. See DNS records.

dns_records[].requiredboolean

true for the return-path MX, SPF and DKIM records, which are needed for verification. DMARC, tracking and inbound records are optional.

dns_records[].typestring

MX, TXT or CNAME.

dns_records[].namestring

Host name of the record.

dns_records[].valuestring

Value to publish.

dns_records[].priorityinteger | null

MX priority, or null for other types.

dns_records[].ttlstring

Always auto.

dns_records[].statusstring

Result of the last DNS check: pending, ok, missing or invalid.

dns_records[].errorstring | null

Why the last check failed, or null.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.updated",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "verified_at": "2026-09-28T08:40:19.226000+00:00",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": true,
    "track_clicks": true,
    "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
    "created_at": "2026-09-28T08:31:52.690000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "verified_at": "2026-09-28T08:40:19.226000+00:00",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": true,
      "track_clicks": true,
      "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
      "created_at": "2026-09-28T08:31:52.690000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}

domain.deleted

Sent when a sending domain is deleted, for example with Delete a domain. The payload is the domain as it was before it was deleted.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

Event ID (evt_…). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with Retrieve an event.

typestring

Always domain.deleted.

objectobject

The domain the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Domain object

idstring

Domain ID (dom_…).

objectstring

Always domain.

namestring

Domain name, for example acme.com.

verified_atstring | null

When the domain was verified, or null if it isn’t verified.

tracking_keystring | null

Custom subdomain for the tracking CNAME, or null for the default go.

inbound_keystring | null

Custom subdomain for the inbound MX record, or null for the default inbound.

track_loadsboolean

Whether open tracking is on by default for emails from this domain.

track_clicksboolean

Whether click tracking is on by default for emails from this domain.

dns_checked_atstring | null

When Emailit last checked the DNS records.

created_atstring

When the domain was added, in ISO 8601 with a UTC offset.

dns_recordsobject[]

DNS records for the domain. See DNS records.

dns_records[].requiredboolean

true for the return-path MX, SPF and DKIM records, which are needed for verification. DMARC, tracking and inbound records are optional.

dns_records[].typestring

MX, TXT or CNAME.

dns_records[].namestring

Host name of the record.

dns_records[].valuestring

Value to publish.

dns_records[].priorityinteger | null

MX priority, or null for other types.

dns_records[].ttlstring

Always auto.

dns_records[].statusstring

Result of the last DNS check: pending, ok, missing or invalid.

dns_records[].errorstring | null

Why the last check failed, or null.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.deleted",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "verified_at": "2026-09-28T08:40:19.226000+00:00",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": true,
    "track_clicks": true,
    "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
    "created_at": "2026-09-28T08:31:52.690000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "verified_at": "2026-09-28T08:40:19.226000+00:00",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": true,
      "track_clicks": true,
      "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
      "created_at": "2026-09-28T08:31:52.690000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}

Was this page helpful?

Thanks for the feedback.

Thanks, we read every message.