# Domain-Events

> Erstellte, aktualisierte oder gelöschte Versanddomains.



## domain.created

> Wird gesendet, wenn dem Workspace eine Versanddomain hinzugefügt wird. Enthält die anzulegenden DNS-Einträge, alle mit dem Status pending.

# domain.created

Wird gesendet, wenn dem Workspace eine Versanddomain hinzugefügt wird, zum Beispiel mit [Domain erstellen](/de/docs/api-reference/domains/create/). Der Payload enthält die anzulegenden DNS-Einträge; anfangs haben sie alle den Status `pending`. Siehe [Versanddomain hinzufügen](/de/docs/domains/add-a-domain/).

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe [Webhook-Anfragen](/de/docs/webhooks/webhook-requests/).

```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
        }
      ]
    }
  }
}
```

## Felder

- `event_id` (string): 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](/de/docs/api-reference/events/get/) nachschlagen.

- `type` (string): Immer `domain.created`.

- `object` (object): Die Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

- `data.object` (object): Noch einmal dasselbe Objekt, in der Form, die die [Events-API](/de/docs/api-reference/events/get/) in `data` zurückgibt.

### Domain-Objekt

- `id` (string): Domain-ID (`dom_…`).

- `object` (string): Immer `domain`.

- `name` (string): Domainname, zum Beispiel `acme.com`.

- `tracking_key` (string | null): Eigene Subdomain für den Tracking-CNAME oder `null` für den Standardwert `go`.

- `inbound_key` (string | null): Eigene Subdomain für den Inbound-MX-Eintrag oder `null` für den Standardwert `inbound`.

- `track_loads` (boolean): Ob Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

- `track_clicks` (boolean): Ob Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

- `created_at` (string): Zeitpunkt, zu dem die Domain hinzugefügt wurde, im Format ISO 8601 mit UTC-Offset.

- `dns_records` (object[]): DNS-Einträge der Domain. Siehe [DNS-Einträge](/de/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `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[].type` (string): `MX`, `TXT` oder `CNAME`.

- `dns_records[].name` (string): Hostname des Eintrags.

- `dns_records[].value` (string): Einzutragender Wert.

- `dns_records[].priority` (integer | null): MX-Priorität oder `null` bei anderen Typen.

- `dns_records[].ttl` (string): Immer `auto`.

- `dns_records[].status` (string): Ergebnis der letzten DNS-Prüfung: `pending`, `ok`, `missing` oder `invalid`.

- `dns_records[].error` (string | null): Grund, warum die letzte Prüfung fehlgeschlagen ist, oder `null`.

---
Quelle: https://emailit.com/de/docs/webhooks/events/domain/domain-created/

## domain.updated

> Wird gesendet, wenn sich die Einstellungen einer Versanddomain ändern, etwa die Tracking- oder Inbound-Optionen. Verifizierungsprüfungen lösen es nicht aus.

# domain.updated

Wird gesendet, wenn sich die Einstellungen einer Domain ändern, zum Beispiel ihre Tracking- oder Inbound-Optionen, mit [Domain aktualisieren](/de/docs/api-reference/domains/update/) oder in der Weboberfläche. DNS-Prüfungen und die Verifizierung lösen dieses Event nicht aus; den Verifizierungsstatus verfolgen Sie mit [Domain abrufen](/de/docs/api-reference/domains/get/).

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe [Webhook-Anfragen](/de/docs/webhooks/webhook-requests/).

```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
        }
      ]
    }
  }
}
```

## Felder

- `event_id` (string): 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](/de/docs/api-reference/events/get/) nachschlagen.

- `type` (string): Immer `domain.updated`.

- `object` (object): Die Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

- `data.object` (object): Noch einmal dasselbe Objekt, in der Form, die die [Events-API](/de/docs/api-reference/events/get/) in `data` zurückgibt.

### Domain-Objekt

- `id` (string): Domain-ID (`dom_…`).

- `object` (string): Immer `domain`.

- `name` (string): Domainname, zum Beispiel `acme.com`.

- `verified_at` (string | null): Zeitpunkt der Verifizierung der Domain oder `null`, wenn sie nicht verifiziert ist.

- `tracking_key` (string | null): Eigene Subdomain für den Tracking-CNAME oder `null` für den Standardwert `go`.

- `inbound_key` (string | null): Eigene Subdomain für den Inbound-MX-Eintrag oder `null` für den Standardwert `inbound`.

- `track_loads` (boolean): Ob Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

- `track_clicks` (boolean): Ob Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

- `dns_checked_at` (string | null): Zeitpunkt, zu dem Emailit die DNS-Einträge zuletzt geprüft hat.

- `created_at` (string): Zeitpunkt, zu dem die Domain hinzugefügt wurde, im Format ISO 8601 mit UTC-Offset.

- `dns_records` (object[]): DNS-Einträge der Domain. Siehe [DNS-Einträge](/de/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `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[].type` (string): `MX`, `TXT` oder `CNAME`.

- `dns_records[].name` (string): Hostname des Eintrags.

- `dns_records[].value` (string): Einzutragender Wert.

- `dns_records[].priority` (integer | null): MX-Priorität oder `null` bei anderen Typen.

- `dns_records[].ttl` (string): Immer `auto`.

- `dns_records[].status` (string): Ergebnis der letzten DNS-Prüfung: `pending`, `ok`, `missing` oder `invalid`.

- `dns_records[].error` (string | null): Grund, warum die letzte Prüfung fehlgeschlagen ist, oder `null`.

---
Quelle: https://emailit.com/de/docs/webhooks/events/domain/domain-updated/

## domain.deleted

> Wird gesendet, wenn eine Versanddomain aus dem Workspace gelöscht wird. Der Payload ist die Domain im Zustand vor dem Löschen.

# domain.deleted

Wird gesendet, wenn eine Versanddomain gelöscht wird, zum Beispiel mit [Domain löschen](/de/docs/api-reference/domains/delete/). Der Payload ist die Domain im Zustand vor dem Löschen.

Webhook-Anfragen enthalten ein JSON-Array mit Events wie diesem; siehe [Webhook-Anfragen](/de/docs/webhooks/webhook-requests/).

```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
        }
      ]
    }
  }
}
```

## Felder

- `event_id` (string): 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](/de/docs/api-reference/events/get/) nachschlagen.

- `type` (string): Immer `domain.deleted`.

- `object` (object): Die Domain, die das Event beschreibt. Ihre Felder sind unten aufgeführt.

- `data.object` (object): Noch einmal dasselbe Objekt, in der Form, die die [Events-API](/de/docs/api-reference/events/get/) in `data` zurückgibt.

### Domain-Objekt

- `id` (string): Domain-ID (`dom_…`).

- `object` (string): Immer `domain`.

- `name` (string): Domainname, zum Beispiel `acme.com`.

- `verified_at` (string | null): Zeitpunkt der Verifizierung der Domain oder `null`, wenn sie nicht verifiziert ist.

- `tracking_key` (string | null): Eigene Subdomain für den Tracking-CNAME oder `null` für den Standardwert `go`.

- `inbound_key` (string | null): Eigene Subdomain für den Inbound-MX-Eintrag oder `null` für den Standardwert `inbound`.

- `track_loads` (boolean): Ob Öffnungs-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

- `track_clicks` (boolean): Ob Klick-Tracking für E-Mails von dieser Domain standardmäßig aktiviert ist.

- `dns_checked_at` (string | null): Zeitpunkt, zu dem Emailit die DNS-Einträge zuletzt geprüft hat.

- `created_at` (string): Zeitpunkt, zu dem die Domain hinzugefügt wurde, im Format ISO 8601 mit UTC-Offset.

- `dns_records` (object[]): DNS-Einträge der Domain. Siehe [DNS-Einträge](/de/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `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[].type` (string): `MX`, `TXT` oder `CNAME`.

- `dns_records[].name` (string): Hostname des Eintrags.

- `dns_records[].value` (string): Einzutragender Wert.

- `dns_records[].priority` (integer | null): MX-Priorität oder `null` bei anderen Typen.

- `dns_records[].ttl` (string): Immer `auto`.

- `dns_records[].status` (string): Ergebnis der letzten DNS-Prüfung: `pending`, `ok`, `missing` oder `invalid`.

- `dns_records[].error` (string | null): Grund, warum die letzte Prüfung fehlgeschlagen ist, oder `null`.

---
Quelle: https://emailit.com/de/docs/webhooks/events/domain/domain-deleted/
