Domain events
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_idstringEvent 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.
typestringAlways domain.created.
objectobjectThe domain the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Domain object
idstringDomain ID (dom_…).
objectstringAlways domain.
namestringDomain name, for example acme.com.
tracking_keystring | nullCustom subdomain for the tracking CNAME, or null for the default go.
inbound_keystring | nullCustom subdomain for the inbound MX record, or null for the default inbound.
track_loadsbooleanWhether open tracking is on by default for emails from this domain.
track_clicksbooleanWhether click tracking is on by default for emails from this domain.
created_atstringWhen the domain was added, in ISO 8601 with a UTC offset.
dns_recordsobject[]DNS records for the domain. See DNS records.
dns_records[].requiredbooleantrue for the return-path MX, SPF and DKIM records, which are needed for verification. DMARC, tracking and inbound records are optional.
dns_records[].typestringMX, TXT or CNAME.
dns_records[].namestringHost name of the record.
dns_records[].valuestringValue to publish.
dns_records[].priorityinteger | nullMX priority, or null for other types.
dns_records[].ttlstringAlways auto.
dns_records[].statusstringResult of the last DNS check: pending, ok, missing or invalid.
dns_records[].errorstring | nullWhy the last check failed, or null.
{
"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_idstringEvent 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.
typestringAlways domain.updated.
objectobjectThe domain the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Domain object
idstringDomain ID (dom_…).
objectstringAlways domain.
namestringDomain name, for example acme.com.
verified_atstring | nullWhen the domain was verified, or null if it isn’t verified.
tracking_keystring | nullCustom subdomain for the tracking CNAME, or null for the default go.
inbound_keystring | nullCustom subdomain for the inbound MX record, or null for the default inbound.
track_loadsbooleanWhether open tracking is on by default for emails from this domain.
track_clicksbooleanWhether click tracking is on by default for emails from this domain.
dns_checked_atstring | nullWhen Emailit last checked the DNS records.
created_atstringWhen the domain was added, in ISO 8601 with a UTC offset.
dns_recordsobject[]DNS records for the domain. See DNS records.
dns_records[].requiredbooleantrue for the return-path MX, SPF and DKIM records, which are needed for verification. DMARC, tracking and inbound records are optional.
dns_records[].typestringMX, TXT or CNAME.
dns_records[].namestringHost name of the record.
dns_records[].valuestringValue to publish.
dns_records[].priorityinteger | nullMX priority, or null for other types.
dns_records[].ttlstringAlways auto.
dns_records[].statusstringResult of the last DNS check: pending, ok, missing or invalid.
dns_records[].errorstring | nullWhy the last check failed, or null.
{
"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_idstringEvent 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.
typestringAlways domain.deleted.
objectobjectThe domain the event describes. Its fields are listed below.
data.objectobjectThe same object again, in the shape that the Events API returns in data.
Domain object
idstringDomain ID (dom_…).
objectstringAlways domain.
namestringDomain name, for example acme.com.
verified_atstring | nullWhen the domain was verified, or null if it isn’t verified.
tracking_keystring | nullCustom subdomain for the tracking CNAME, or null for the default go.
inbound_keystring | nullCustom subdomain for the inbound MX record, or null for the default inbound.
track_loadsbooleanWhether open tracking is on by default for emails from this domain.
track_clicksbooleanWhether click tracking is on by default for emails from this domain.
dns_checked_atstring | nullWhen Emailit last checked the DNS records.
created_atstringWhen the domain was added, in ISO 8601 with a UTC offset.
dns_recordsobject[]DNS records for the domain. See DNS records.
dns_records[].requiredbooleantrue for the return-path MX, SPF and DKIM records, which are needed for verification. DMARC, tracking and inbound records are optional.
dns_records[].typestringMX, TXT or CNAME.
dns_records[].namestringHost name of the record.
dns_records[].valuestringValue to publish.
dns_records[].priorityinteger | nullMX priority, or null for other types.
dns_records[].ttlstringAlways auto.
dns_records[].statusstringResult of the last DNS check: pending, ok, missing or invalid.
dns_records[].errorstring | nullWhy the last check failed, or null.
{
"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
}
]
}
}
}