# Versanddomain hinzufügen

> Fügen Sie Ihre Domain zu Emailit hinzu, legen Sie die erzeugten DNS-Einträge an, senden Sie sie bei Bedarf an einen Entwickler und verifizieren Sie die Domain, damit Sie senden können.

Diese Anleitung führt Sie durch das Hinzufügen einer Versanddomain, das Anlegen ihrer DNS-Einträge und ihre Verifizierung. Sie brauchen dafür ein paar Minuten, plus die Zeit, die Ihr DNS-Anbieter zum Veröffentlichen der Einträge benötigt.

## Voraussetzungen

- Sie benötigen Zugriff auf die DNS-Einstellungen der Domain oder eine Person, die ihn hat. Sie können ihr [die Einträge per E-Mail senden](#send-the-records-to-someone-else).
- Entscheiden Sie, von welcher Domain Sie senden. Eine Subdomain wie `mail.acme.com` hält Ihre Absenderreputation von Ihrer Hauptdomain getrennt. Siehe [Hauptdomain oder Subdomain?](/de/docs/domains/#root-domain-or-subdomain)
- Prüfen Sie, ob Ihr Tarif Platz für eine weitere Domain hat. Siehe [Domain-Limits](/de/docs/domains/limits/).
- Für die API verwenden Sie einen API-Schlüssel mit **Full Access**. Reine Sende-Schlüssel können keine Domains verwalten.

## Regeln für Domainnamen

- Geben Sie die reine Domain ein: `acme.com` oder `mail.acme.com`. Lassen Sie `http://`, `https://` und das Präfix `www.` weg.
- Verwenden Sie Buchstaben, Ziffern, Bindestriche und Punkte, mit einer Top-Level-Domain aus mindestens zwei Buchstaben. Emailit speichert den Namen in Kleinbuchstaben.
- Subdomains beliebiger Tiefe sind erlaubt, zum Beispiel `eu.mail.acme.com`. Jede ist eine eigene Domain mit eigenen Einträgen.
- Ein Name kann pro Workspace nur einmal hinzugefügt werden. Ein erneutes Hinzufügen gibt `409 Domain with this name already exists` zurück.

## Domain hinzufügen

**Weboberfläche**

  1. **Domains öffnen.** Öffnen Sie **Email API → Domains** und wählen Sie **Add domain**.

     Ist die Schaltfläche deaktiviert, hat Ihr Workspace sein Domain-Limit erreicht. Das Badge neben dem Seitentitel zeigt, wie viele Sie verwenden.

  2. **Domain eingeben.** Geben Sie in **Name** die Domain ein, von der Sie senden, zum Beispiel `mail.acme.com`, und wählen Sie **Create**.

  3. **Einträge prüfen.** Emailit öffnet die Domainseite im Tab **DNS Setup**. Er listet jeden Eintrag mit Typ, Name, Wert, Priorität und TTL auf, mit einer Kopierschaltfläche für jeden Wert.

**API**

  Rufen Sie [Domain erstellen](/de/docs/api-reference/domains/create/) mit dem Domainnamen auf.

```bash
curl https://api.emailit.com/v2/domains \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.acme.com" }'
```

  Die Antwort `201` enthält die `id` der Domain und ein Array `dns_records` mit jedem Eintrag, den Sie anlegen müssen:

```json
{
  "object": "domain",
  "id": "dom_2kq8Vt4xLm7Rz",
  "name": "mail.acme.com",
  "verification_status": "pending",
  "manual_review_required": false,
  "spf_status": "pending",
  "dkim_status": "pending",
  "return_path_status": "pending",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.mail.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.mail.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}
```

  Die vollständige Antwort listet alle sechs Einträge auf, einschließlich DKIM, DMARC, Tracking und Inbound. Beim Erstellen der Domain können Sie außerdem diese optionalen Felder setzen:

  | Feld | Standardwert | Beschreibung |
  | --- | --- | --- |
  | `tracking_key` | `go` | Subdomain-Präfix für den Tracking-CNAME. Siehe [Eigene Tracking-Domain](/de/docs/tracking/custom-tracking-domain/). |
  | `inbound_key` | `inbound` | Subdomain-Präfix für den Inbound-MX-Eintrag. |
  | `dmarc_reports` | `false` | Fügt die Berichtsadresse von Emailit zum vorgeschlagenen DMARC-Eintrag hinzu. Nur in Pro, Business und Custom, sonst `403 plan_required`. |

  `track_loads` und `track_clicks` lassen sich beim Erstellen einer Domain nicht aktivieren, weil Tracking zuerst einen verifizierten Tracking-CNAME braucht. Das Senden von `true` gibt `422` zurück.

Es gibt keinen eigenen Schalter für ausgehende oder eingehende E-Mails. Eine verifizierte Domain kann senden, und sie empfängt eingehende E-Mails, sobald ihr Inbound-MX-Eintrag angelegt ist. Die API akzeptiert die Flags `outgoing` und `incoming` aus Kompatibilitätsgründen, sie ändern aber nichts am Verhalten der Domain.

## DNS-Einträge anlegen

Legen Sie die Einträge bei dem Unternehmen an, das das DNS Ihrer Domain hostet. Das ist oft Ihr Registrar (GoDaddy, Namecheap) oder ein DNS-Dienst (Cloudflare, Amazon Route 53).

| Eintrag | Typ | Host | Was Sie tun |
| --- | --- | --- | --- |
| Return-Path | MX | `emailit.<domain>` | Erforderlich. Priorität 10. |
| SPF | TXT | `emailit.<domain>` | Erforderlich. |
| DKIM | TXT | `emailit._domainkey.<domain>` | Erforderlich. Fügen Sie den vollständigen Wert ein. |
| DMARC | TXT | `_dmarc.<domain>` | Empfohlen. Lassen Sie ihn weg, wenn die Domain bereits einen DMARC-Eintrag hat. |
| Tracking | CNAME | `go.<domain>` | Nur wenn Sie Öffnungs- und Klick-Tracking möchten. |
| Inbound | MX | `inbound.<domain>` | Nur wenn Sie E-Mails empfangen möchten. Priorität 10. |

Die meisten DNS-Anbieter erwarten im Host-Feld nur den Teil vor Ihrer Domain (`emailit`, nicht `emailit.acme.com`). [DNS-Einträge](/de/docs/domains/dns-records/) enthält die genauen Werte, Tipps für einzelne Anbieter und häufige Fehler.

Nutzt Ihre Domain Cloudflare-DNS, bietet die Domainseite **Set up with Cloudflare** an, das die Einträge für Sie erstellt. Siehe [DNS mit Cloudflare einrichten](/de/docs/domains/cloudflare/).

## Einträge an jemand anderen senden

Wenn jemand anderes Ihr DNS verwaltet, senden Sie dieser Person die Einträge per E-Mail aus der Weboberfläche.

1. **Domain öffnen.** Wählen Sie unter **Email API → Domains** die Domain aus.

2. **Send to email wählen.** Die Option steht oben rechts in der Karte **DNS Setup**.

3. **Adresse eingeben.** Geben Sie in **Recipient Email** die Adresse Ihres Entwicklers oder IT-Administrators ein und wählen Sie **Send Instructions**.

Die Person erhält von Emailit eine E-Mail mit jedem Eintrag und seinem Wert. Bitten Sie sie, Ihnen Bescheid zu geben, wenn die Einträge angelegt sind, damit Sie die Prüfung starten können.

## DNS prüfen und verifizieren

**Weboberfläche**

  Wählen Sie auf der Domainseite **Check DNS**. Emailit fragt jeden Eintrag ab und aktualisiert den Status daneben: **OK**, **Missing**, **Invalid** oder **Not checked**. Bewegen Sie den Mauszeiger auf **Missing** oder **Invalid**, um zu sehen, was Emailit gefunden hat.

**API**

  Rufen Sie [Domain verifizieren](/de/docs/api-reference/domains/verify/) auf. Sie können die Domain-ID oder ihren Namen verwenden.

```bash
curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  Die Antwort enthält die aktualisierte Domain. Prüfen Sie `verification_status` sowie `status` und `error` jedes Elements in `dns_records`.

> **Die Verifizierung läuft nur auf Anforderung:** Emailit verifiziert eine neue Domain nicht von selbst. Nachdem Sie Einträge angelegt oder korrigiert haben, führen Sie **Check DNS** erneut aus. DNS-Änderungen erscheinen meist innerhalb von Minuten, manche Anbieter brauchen aber bis zu 48 Stunden.

Die Domain ist verifiziert, wenn SPF, DKIM und Return-Path alle **OK** zeigen. DMARC, Tracking und Inbound sind optional und beeinflussen die Verifizierung nicht.

## Ergebnis prüfen

- Die Domain zeigt unter **Email API → Domains** den Status **Verified**, und die Spalten **SPF**, **DKIM** und **Return Path** zeigen **OK**.
- Senden Sie eine Testnachricht von einer Adresse auf der Domain. Wählen Sie auf der Seite **Emails** die Option **Compose** oder rufen Sie [E-Mail senden](/de/docs/api-reference/emails/send/) auf.

Zeigt die Domain **Pending verification**, wartet sie auf eine manuelle Prüfung. Das betrifft Domains bei Pay as you go, die vor weniger als 30 Tagen registriert wurden. Siehe [Domain-Verifizierung](/de/docs/domains/verification/#pending-verification).

> **Hinweis:** Eine verifizierte Domain hebt den Sandbox-Modus nicht auf. Bis Ihr Workspace Produktionszugang hat, können Sie nur an die Kontoadressen von Mitgliedern des Workspace senden. Siehe [Produktionszugang](/de/docs/workspaces/production-access/).

## Fehlerbehebung

| Problem | Lösung |
| --- | --- |
| **Add domain** ist deaktiviert | Sie haben das Domain-Limit Ihres Tarifs erreicht. Löschen Sie eine ungenutzte Domain oder erhöhen Sie das Limit. Siehe [Domain-Limits](/de/docs/domains/limits/). |
| `The domain must be in apex format` | Entfernen Sie `http://`, `https://` oder `www.` und stellen Sie sicher, dass der Name auf eine echte Top-Level-Domain endet. |
| Einträge zeigen nach einer Stunde **Missing** | Der Host ist wahrscheinlich doppelt, zum Beispiel `emailit.acme.com.acme.com`. Geben Sie im Host-Feld nur `emailit` ein. |
| DKIM zeigt **Invalid** | Ein Teil des Werts wurde abgeschnitten. Kopieren Sie ihn erneut mit der Kopierschaltfläche. |

[Domain-Verifizierung](/de/docs/domains/verification/#troubleshooting) behandelt weitere Fälle.

## Siehe auch

  - [DNS-Einträge](/de/docs/domains/dns-records/): Referenz aller Einträge, die Emailit erzeugt.
  - [Domain-Verifizierung](/de/docs/domains/verification/): Status, manuelle Prüfung und tägliche Prüfungen.
  - [Eigene Tracking-Domain](/de/docs/tracking/custom-tracking-domain/): Öffnungs- und Klick-Tracking einrichten.
  - [Eingehende E-Mails einrichten](/de/docs/inbound/set-up/): E-Mails auf Ihrer Domain empfangen.

---
Quelle: https://emailit.com/de/docs/domains/add-a-domain/