Zum Inhalt springen
Doku

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_idstring

Event-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.

typestring

Immer domain.created.

objectobject

Die Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Domain-Objekt

idstring

Domain-ID (dom_…).

objectstring

Immer domain.

namestring

Domainname, zum Beispiel acme.com.

tracking_keystring | null

Eigene Subdomain für den Tracking-CNAME oder null für den Standardwert go.

inbound_keystring | null

Eigene Subdomain für den Inbound-MX-Eintrag oder null für den Standardwert inbound.

track_loadsboolean

Ob Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

track_clicksboolean

Ob Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

created_atstring

Zeitpunkt, 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[].requiredboolean

true 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[].typestring

MX, TXT oder CNAME.

dns_records[].namestring

Hostname des Eintrags.

dns_records[].valuestring

Einzutragender Wert.

dns_records[].priorityinteger | null

MX-Priorität oder null bei anderen Typen.

dns_records[].ttlstring

Immer auto.

dns_records[].statusstring

Ergebnis der letzten DNS-Prüfung: pending, ok, missing oder invalid.

dns_records[].errorstring | null

Grund, warum die letzte Prüfung fehlgeschlagen ist, oder 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

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_idstring

Event-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.

typestring

Immer domain.updated.

objectobject

Die Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Domain-Objekt

idstring

Domain-ID (dom_…).

objectstring

Immer domain.

namestring

Domainname, zum Beispiel acme.com.

verified_atstring | null

Zeitpunkt der Verifizierung der Domain oder null, wenn sie nicht verifiziert ist.

tracking_keystring | null

Eigene Subdomain für den Tracking-CNAME oder null für den Standardwert go.

inbound_keystring | null

Eigene Subdomain für den Inbound-MX-Eintrag oder null für den Standardwert inbound.

track_loadsboolean

Ob Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

track_clicksboolean

Ob Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

dns_checked_atstring | null

Zeitpunkt, zu dem Emailit die DNS-Einträge zuletzt geprüft hat.

created_atstring

Zeitpunkt, 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[].requiredboolean

true 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[].typestring

MX, TXT oder CNAME.

dns_records[].namestring

Hostname des Eintrags.

dns_records[].valuestring

Einzutragender Wert.

dns_records[].priorityinteger | null

MX-Priorität oder null bei anderen Typen.

dns_records[].ttlstring

Immer auto.

dns_records[].statusstring

Ergebnis der letzten DNS-Prüfung: pending, ok, missing oder invalid.

dns_records[].errorstring | null

Grund, warum die letzte Prüfung fehlgeschlagen ist, oder 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

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_idstring

Event-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.

typestring

Immer domain.deleted.

objectobject

Die Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

data.objectobject

Noch einmal dasselbe Objekt, in der Form, die die Events-API in data zurückgibt.

Domain-Objekt

idstring

Domain-ID (dom_…).

objectstring

Immer domain.

namestring

Domainname, zum Beispiel acme.com.

verified_atstring | null

Zeitpunkt der Verifizierung der Domain oder null, wenn sie nicht verifiziert ist.

tracking_keystring | null

Eigene Subdomain für den Tracking-CNAME oder null für den Standardwert go.

inbound_keystring | null

Eigene Subdomain für den Inbound-MX-Eintrag oder null für den Standardwert inbound.

track_loadsboolean

Ob Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

track_clicksboolean

Ob Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

dns_checked_atstring | null

Zeitpunkt, zu dem Emailit die DNS-Einträge zuletzt geprüft hat.

created_atstring

Zeitpunkt, 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[].requiredboolean

true 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[].typestring

MX, TXT oder CNAME.

dns_records[].namestring

Hostname des Eintrags.

dns_records[].valuestring

Einzutragender Wert.

dns_records[].priorityinteger | null

MX-Priorität oder null bei anderen Typen.

dns_records[].ttlstring

Immer auto.

dns_records[].statusstring

Ergebnis der letzten DNS-Prüfung: pending, ok, missing oder invalid.

dns_records[].errorstring | null

Grund, warum die letzte Prüfung fehlgeschlagen ist, oder 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
        }
      ]
    }
  }
}

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.