Domain-Events
Erstellte, aktualisierte oder gelöschte Versanddomains.
domain.created
Wird gesendet, wenn dem Workspace eine Versanddomain hinzugefügt wird, zum Beispiel mit Domain erstellen. Der Payload enthält die anzulegenden DNS-Einträge; anfangs haben sie alle den Status pending. Siehe Versanddomain hinzufügen.
Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.
Felder
event_idstringEvent-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.
typestringImmer domain.created.
objectobjectDie Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.
data.objectobjectNoch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.
Domain-Objekt
idstringDomain-ID (dom_…).
objectstringImmer domain.
namestringDomainname, zum Beispiel acme.com.
tracking_keystring | nullEigene Subdomain für den Tracking-CNAME oder null für den Standardwert go.
inbound_keystring | nullEigene Subdomain für den Inbound-MX-Eintrag oder null für den Standardwert inbound.
track_loadsbooleanOb Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.
track_clicksbooleanOb Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.
created_atstringZeitpunkt, zu dem die Domain hinzugefügt wurde, im Format ISO 8601 mit UTC-Offset.
dns_recordsobject[]DNS-Einträge der Domain. Siehe DNS-Einträge.
dns_records[].requiredbooleantrue für den MX-Eintrag des Return-Path sowie die SPF- und DKIM-Einträge, die für die Verifizierung erforderlich sind. DMARC-, Tracking- und Inbound-Einträge sind optional.
dns_records[].typestringMX, TXT oder CNAME.
dns_records[].namestringHostname des Eintrags.
dns_records[].valuestringEinzutragender Wert.
dns_records[].priorityinteger | nullMX-Priorität oder null bei anderen Typen.
dns_records[].ttlstringImmer auto.
dns_records[].statusstringErgebnis der letzten DNS-Prüfung: pending, ok, missing oder invalid.
dns_records[].errorstring | nullGrund, warum die letzte Prüfung fehlgeschlagen ist, oder 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
Wird gesendet, wenn sich die Einstellungen einer Domain ändern, zum Beispiel ihre Tracking- oder Inbound-Optionen, mit Domain aktualisieren oder in der Weboberfläche. DNS-Prüfungen und die Verifizierung lösen dieses Event nicht aus; den Verifizierungsstatus verfolgen Sie mit Domain abrufen.
Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.
Felder
event_idstringEvent-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.
typestringImmer domain.updated.
objectobjectDie Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.
data.objectobjectNoch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.
Domain-Objekt
idstringDomain-ID (dom_…).
objectstringImmer domain.
namestringDomainname, zum Beispiel acme.com.
verified_atstring | nullZeitpunkt der Verifizierung der Domain oder null, wenn sie nicht verifiziert ist.
tracking_keystring | nullEigene Subdomain für den Tracking-CNAME oder null für den Standardwert go.
inbound_keystring | nullEigene Subdomain für den Inbound-MX-Eintrag oder null für den Standardwert inbound.
track_loadsbooleanOb Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.
track_clicksbooleanOb Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.
dns_checked_atstring | nullZeitpunkt, zu dem Emailit die DNS-Einträge zuletzt geprüft hat.
created_atstringZeitpunkt, zu dem die Domain hinzugefügt wurde, im Format ISO 8601 mit UTC-Offset.
dns_recordsobject[]DNS-Einträge der Domain. Siehe DNS-Einträge.
dns_records[].requiredbooleantrue für den MX-Eintrag des Return-Path sowie die SPF- und DKIM-Einträge, die für die Verifizierung erforderlich sind. DMARC-, Tracking- und Inbound-Einträge sind optional.
dns_records[].typestringMX, TXT oder CNAME.
dns_records[].namestringHostname des Eintrags.
dns_records[].valuestringEinzutragender Wert.
dns_records[].priorityinteger | nullMX-Priorität oder null bei anderen Typen.
dns_records[].ttlstringImmer auto.
dns_records[].statusstringErgebnis der letzten DNS-Prüfung: pending, ok, missing oder invalid.
dns_records[].errorstring | nullGrund, warum die letzte Prüfung fehlgeschlagen ist, oder 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
Wird gesendet, wenn eine Versanddomain gelöscht wird, zum Beispiel mit Domain löschen. Der Payload ist die Domain im Zustand vor dem Löschen.
Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe Webhook-Anfragen.
Felder
event_idstringEvent-ID (evt_…). Eine wiederholte Anfrage enthält dieselbe ID. Damit können Sie Events überspringen, die Sie bereits verarbeitet haben. Sie können das Event auch mit Event abrufen nachschlagen.
typestringImmer domain.deleted.
objectobjectDie Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.
data.objectobjectNoch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.
Domain-Objekt
idstringDomain-ID (dom_…).
objectstringImmer domain.
namestringDomainname, zum Beispiel acme.com.
verified_atstring | nullZeitpunkt der Verifizierung der Domain oder null, wenn sie nicht verifiziert ist.
tracking_keystring | nullEigene Subdomain für den Tracking-CNAME oder null für den Standardwert go.
inbound_keystring | nullEigene Subdomain für den Inbound-MX-Eintrag oder null für den Standardwert inbound.
track_loadsbooleanOb Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.
track_clicksbooleanOb Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.
dns_checked_atstring | nullZeitpunkt, zu dem Emailit die DNS-Einträge zuletzt geprüft hat.
created_atstringZeitpunkt, zu dem die Domain hinzugefügt wurde, im Format ISO 8601 mit UTC-Offset.
dns_recordsobject[]DNS-Einträge der Domain. Siehe DNS-Einträge.
dns_records[].requiredbooleantrue für den MX-Eintrag des Return-Path sowie die SPF- und DKIM-Einträge, die für die Verifizierung erforderlich sind. DMARC-, Tracking- und Inbound-Einträge sind optional.
dns_records[].typestringMX, TXT oder CNAME.
dns_records[].namestringHostname des Eintrags.
dns_records[].valuestringEinzutragender Wert.
dns_records[].priorityinteger | nullMX-Priorität oder null bei anderen Typen.
dns_records[].ttlstringImmer auto.
dns_records[].statusstringErgebnis der letzten DNS-Prüfung: pending, ok, missing oder invalid.
dns_records[].errorstring | nullGrund, warum die letzte Prüfung fehlgeschlagen ist, oder 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
}
]
}
}
}