---
title: Domains
description: Eine Absenderdomain verifizieren, ihre DNS-Einträge anlegen und sie für Tracking, Empfang und die Aufwärmphase einrichten.
seo:
  title: Absenderdomain einrichten
ai:
  exclude: true
---

Jede E-Mail muss von einer Domain gesendet werden, die Ihr Team verifiziert hat. Jede andere `from`-Adresse wird mit `422` abgelehnt. Fügen Sie Domains im Dashboard unter **Domains** hinzu und verifizieren Sie sie dort, oder nutzen Sie die API.

## Eine Domain hinzufügen und verifizieren

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

Die Antwort listet die DNS-Einträge auf, die Sie bei Ihrem DNS-Anbieter anlegen. Eine Subdomain wie `mail.example.com` eignet sich gut als Absenderdomain. Sobald die Einträge live sind, klicken Sie auf der Domainseite auf **Verifizieren** oder rufen `POST /domains/{id}/verify` auf.

| Eintrag | Zweck |
| --- | --- |
| DKIM (zwei CNAMEs, `bs1._domainkey` und `bs2._domainkey`) | Signiert Ihre E-Mails, damit Anbieter erkennen, dass sie von Ihnen stammen. |
| MAIL FROM (MX und TXT) | Eine Bounce-Adresse auf Ihrer eigenen Domain, damit SPF übereinstimmt. |
| DMARC (TXT, empfohlen) | Sagt Anbietern, was mit E-Mails geschehen soll, die die Prüfungen nicht bestehen. Er blockiert den Versand nicht. |

DKIM und MAIL FROM müssen verifiziert sein, bevor Sie senden können. Lassen Sie diese Einträge bei Cloudflare auf **Nur DNS** (graue Wolke).

Die Domainseite zeigt jeden Eintrag als gefunden, fehlend oder abweichend, live gegen das öffentliche DNS geprüft. `GET /domains/{id}` liefert dasselbe in `records[]`. Jeder Eintrag hat einen `status` (`not_started`, `pending`, `verified` oder `failed`), einen Wert `live` für das, was das öffentliche DNS gerade antwortet, und ein kurzes `detail`, wenn etwas nicht stimmt.

### DKIM-Schlüssel rotieren von selbst

BillionSend erstellt für jede Domain einen DKIM-Schlüssel und ersetzt ihn alle 180 Tage, wobei es zwischen den beiden CNAMEs wechselt. Sie legen die Einträge einmal an und fassen sie nie wieder an. Die automatische Rotation lässt sich im Tab **Einstellungen** der Domain abschalten.

### Region

`POST /domains` akzeptiert ein optionales `region`. Eine Domain liegt in genau einer Region. Um sie zu verschieben, löschen Sie sie und fügen sie in der anderen Region neu hinzu; ihre DNS-Einträge ändern sich dabei.

### Tarifgrenzen

| | Free | Starter | Pro und Scale |
| --- | --- | --- | --- |
| Absenderdomains pro Team | 3 | 10 | Unbegrenzt |

Über dem Limit antwortet `POST /domains` mit `403 plan_limit_reached`. Ein Domainname, den bereits ein anderes Team hält, antwortet mit `409`.

## Aufwärmphase einer neuen Domain

Eine neu registrierte Domain sendet mit begrenztem Tagesvolumen, während sie sich einen Ruf aufbaut. Die Obergrenze hängt vom Alter der registrierten Domain ab (`example.com` bei `mail.example.com`) und zählt pro UTC-Tag:

| Alter der Domain | E-Mails pro Tag |
| --- | --- |
| Unter 1 Tag | 100 |
| 1 bis unter 7 Tage | 300 |
| 7 bis unter 30 Tage | 2.000 |
| 30 Tage oder älter | Nur das Limit Ihres Tarifs |

- Eine Domain, die sauber sendet, mit wenigen Bounces und ohne Beschwerden, rückt früher eine Stufe auf.
- Die Obergrenze gilt zusätzlich zu Ihrem Tarif. Ein Upgrade hebt sie nicht auf.
- Ihre neuen Domains teilen sich ein Tagesvolumen: Eine weitere neue Domain bringt kein zusätzliches Volumen.
- E-Mails über der Obergrenze gehen nicht verloren. Sie erscheinen als **Wartet** und gehen am nächsten Tag hinaus, die ältesten zuerst. Wartet bereits viel Post, antwortet ein Versand mit `429 daily_quota_exceeded`; versuchen Sie es nach dem Wechsel des UTC-Tags erneut.

Solange eine Obergrenze gilt, zeigt die Domainseite „Aufwärmphase: N/Tag heute“. Alle Schutzmaßnahmen beim Versand finden Sie unter [Sendelimits](/docs/de/concepts/sending-limits).

## Einstellungen

Sobald eine Domain verifiziert ist, stehen diese Einstellungen zur Verfügung:

- **Öffnungs- und Klick-Tracking.** Beide sind standardmäßig aus. Schalten Sie sie im Tab **Links** der Domain ein oder mit `open_tracking` und `click_tracking` bei `PATCH /domains/{id}`. Siehe [Tracking](/docs/de/concepts/tracking).
- **Eigene Subdomains für Tracking und Abmeldung.** Liefern Sie getrackte Links und Abmeldelinks von Ihrer eigenen Domain aus. Dafür ist ein kostenpflichtiger Tarif nötig. Siehe [Tracking](/docs/de/concepts/tracking).
- **Abmeldeseite.** Das Aussehen der Seite, die Ihre Empfänger sehen: Name, Logo, Farben und Texte. Stellen Sie es im Tab **Marke** der Domain ein oder mit `unsubscribe_page` bei `PATCH /domains/{id}`. Siehe [Abmeldungen](/docs/de/concepts/unsubscribes).
- **TLS erforderlich.** Nur an Server zustellen, die TLS unterstützen. Einstellbar im Tab **Einstellungen**.
- **Standard-Absendername, Absenderadresse und Reply-To.** Einstellbar im Tab **Einstellungen**.

## Empfang

Eine verifizierte Domain kann auch [E-Mails empfangen](/docs/de/receiving). Aktivieren Sie das mit **Empfang aktivieren** auf der Domainseite oder mit `PATCH /domains/{id}`:

```json
{ "capabilities": { "receiving": "enabled" } }
```

- Nur eine verifizierte Domain kann den Empfang aktivieren. `POST /domains` mit `"receiving": "enabled"` antwortet mit `422`: Fügen Sie die Domain hinzu, verifizieren Sie sie und aktivieren Sie danach den Empfang.
- Beim Aktivieren kommen zwei Einträge vom Typ `Receiving` hinzu: MX-Einträge, die auf `mx1.billionsend-dns.com` und `mx2.billionsend-dns.com` zeigen, beide mit Priorität `10`. Veröffentlichen Sie beide, damit ein Absender, der einen Server nicht erreicht, es beim anderen erneut versucht. Sie wirken sich nicht auf den Versand aus. Empfängt die Domain bereits anderswo E-Mails, legen Sie die MX-Einträge auf eine Subdomain wie `inbound.example.com`, denn ein MX-Eintrag mit niedrigerer Nummer würde die E-Mails stattdessen erhalten.
- Ein Name kann nur in einem Team empfangen. Ein Name, auf dem bereits ein anderes Team empfängt, antwortet mit `409`.
- Standardmäßig empfangen nur die Adressen Ihrer [Postfächer](/docs/de/inboxes) E-Mails. **Catch-all** nimmt jede Adresse der Domain an. Es erfordert einen kostenpflichtigen Tarif und wird im Dashboard oder mit `receiving_catch_all` bei `PATCH /domains/{id}` eingestellt.

## Gemeinsame Subdomain

Jedes Team erhält außerdem eine Subdomain auf einer gemeinsamen BillionSend-Domain, auf der seine gemeinsamen [Postfächer](/docs/de/inboxes) ihre Adressen bekommen. Sie erscheint am Ende von `GET /domains` mit `shared: true`. Sie ist bereits verifiziert und schreibgeschützt: `PATCH`, Verifizieren und `DELETE` antworten mit `403 forbidden`, und sie zählt nicht zu Ihrem Domain-Limit. Sie kann nur von den eigenen Adressen Ihrer Postfächer aus senden.

## Eine Domain löschen

`DELETE /domains/{id}` oder **Löschen** auf der Domainseite wird in zwei Fällen mit `409` abgelehnt:

- Ein [Thema](/docs/de/concepts/topics) oder [Segment](/docs/de/concepts/segments) ist an die Domain gebunden. Löschen Sie es oder setzen Sie sein `domain_id` auf `null`.
- Ein geplanter oder laufender [Newsletter-Versand](/docs/de/concepts/broadcasts) nutzt die Domain. Brechen Sie ihn ab oder warten Sie, bis er hinausgegangen ist.

Beim Löschen einer Domain werden auch ihre Postfächer gelöscht. Die [Abmeldungen](/docs/de/concepts/unsubscribes) von Empfängern bei dieser Domain bleiben erhalten und gelten wieder, wenn Sie denselben Namen erneut hinzufügen.

## API-Schlüssel und Domains

Ein API-Schlüssel lässt sich auf eine Domain beschränken. Ein solcher Schlüssel kann nur von dieser Domain aus senden, und jedes andere `from` antwortet mit `403 restricted_api_key`. Er liest nur die E-Mails, die an dieser Domain eingegangen sind, sieht und ändert unter `/domains` nur diese Domain (jede andere Domain antwortet mit `404`), und die Schlüssel, die er erstellt, sind auf dieselbe Domain beschränkt. Webhooks, Sperrlisten, Vorlagen und alles Übrige, was zum gesamten Team gehört, antworten mit `403 restricted_api_key`; die Seite [API-Schlüssel](/docs/de/api-keys) listet sie auf. Ein Schlüssel lässt sich auch auf ein [Postfach](/docs/de/inboxes) beschränken.
