Domains
Eine Absenderdomain verifizieren, ihre DNS-Einträge anlegen und sie für Tracking, Empfang und die Aufwärmphase einrichten.
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
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.
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_trackingundclick_trackingbeiPATCH /domains/{id}. Siehe 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.
- 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_pagebeiPATCH /domains/{id}. Siehe Abmeldungen. - 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. Aktivieren Sie das mit Empfang aktivieren auf der Domainseite oder mit PATCH /domains/{id}:
{ "capabilities": { "receiving": "enabled" } }
- Nur eine verifizierte Domain kann den Empfang aktivieren.
POST /domainsmit"receiving": "enabled"antwortet mit422: Fügen Sie die Domain hinzu, verifizieren Sie sie und aktivieren Sie danach den Empfang. - Beim Aktivieren kommen zwei Einträge vom Typ
Receivinghinzu: MX-Einträge, die aufmx1.billionsend-dns.comundmx2.billionsend-dns.comzeigen, beide mit Priorität10. 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 wieinbound.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 E-Mails. Catch-all nimmt jede Adresse der Domain an. Es erfordert einen kostenpflichtigen Tarif und wird im Dashboard oder mit
receiving_catch_allbeiPATCH /domains/{id}eingestellt.
Gemeinsame Subdomain
Jedes Team erhält außerdem eine Subdomain auf einer gemeinsamen BillionSend-Domain, auf der seine gemeinsamen Postfächer 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 oder Segment ist an die Domain gebunden. Löschen Sie es oder setzen Sie sein
domain_idaufnull. - Ein geplanter oder laufender Newsletter-Versand 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 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 listet sie auf. Ein Schlüssel lässt sich auch auf ein Postfach beschränken.