MailLandDocs
Domains

Domain hinzufügen

Eine Sendedomain in Ihrem Mail.Land-Workspace hinzufügen und konfigurieren

Bevor Sie über MailLand E-Mails versenden können, müssen Sie mindestens eine Sendedomain hinzufügen und verifizieren. Dies beweist, dass Sie Eigentümer der Domain sind, und autorisiert MailLand, in Ihrem Namen zu versenden.

Domain hinzufügen

POST https://api.mail.land/v1/domains
Add a domain
curl -X POST https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "yourdomain.com"
  }'

Antwort

Status: 201 Created

Domain response
{
  "id": "k3v9x2m8q1w7z4",
  "domain": "yourdomain.com",
  "verificationStatus": "pending",
  "spfStatus": "pending",
  "dkimStatus": "pending",
  "dmarcStatus": "pending",
  "isFullyVerified": false,
  "trackingSubdomain": "track",
  "useCustomTracking": false,
  "bounceSubdomain": "bounce",
  "useCustomBounce": true,
  "inboundEnabled": false,
  "inboundSubdomain": null,
  "mxVerified": false,
  "healthStatus": "unknown",
  "createdAt": "2026-02-17T10:00:00Z",
  "updatedAt": "2026-02-17T10:00:00Z"
}
FeldTypBeschreibung
idstringÖffentliche Domain-ID
domainstringDer Domainname
verificationStatusenumpending, verified oder failed
spfStatus / dkimStatus / dmarcStatusenumpending, valid oder invalid je Eintrag
isFullyVerifiedbooleanEigentum verifiziert UND SPF, DKIM und DMARC alle valid, erforderlich zum Senden
trackingSubdomain / bounceSubdomainstringSubdomains für Tracking/Bounce, unabhängig davon, ob die benutzerdefinierte Domain aktiv ist
useCustomTracking / useCustomBouncebooleanOb die benutzerdefinierte Tracking-/Bounce-Domain aktiviert ist
inboundEnabledbooleanOb eingehender E-Mail-Empfang für diese Domain aktiviert ist
inboundSubdomainstring | nullSubdomain für den eingehenden MX-Eintrag; null bedeutet die Domain-Wurzel
mxVerifiedbooleanOb der eingehende MX-Eintrag verifiziert ist
healthStatusenumunknown, healthy, warning oder critical
createdAtdatetimeZeitpunkt, zu dem die Domain hinzugefügt wurde

Es gibt kein Verifizierungs-Token: Das Hinzufügen einer Domain erstellt den Datensatz und generiert automatisch ihren DKIM-Schlüssel (kein Token-Schritt).

Nach dem Hinzufügen einer Domain müssen Sie DNS-Einträge konfigurieren und die Eigentümerschaft verifizieren, bevor Sie E-Mails versenden können. Unter DNS-Einrichtung finden Sie die erforderlichen Einträge.

Einrichtungsablauf

Domain hinzufügen

Rufen Sie POST /v1/domains mit Ihrem Domainnamen auf. MailLand erstellt den Domain-Datensatz und generiert ihren DKIM-Schlüssel.

DNS-Anweisungen abrufen

Rufen Sie GET /v1/domains/{id}/dns-instructions auf, um die genauen DNS-Einträge abzurufen, die Sie erstellen müssen. Siehe DNS-Einrichtung.

DNS-Einträge konfigurieren

Fügen Sie die SPF-, DKIM- und DMARC-Einträge (plus die optionalen Bounce-/Tracking-CNAMEs, falls aktiviert) bei Ihrem DNS-Anbieter hinzu.

Domain verifizieren

Rufen Sie POST /v1/domains/{id}/verify auf, um die Verifizierung auszulösen. MailLand überprüft alle DNS-Einträge und aktualisiert den Domain-Status. Siehe Verifizierung.

Domains auflisten

GET https://api.mail.land/v1/domains
List domains
curl https://api.mail.land/v1/domains \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."
List response
{
  "items": [
    {
      "id": "k3v9x2m8q1w7z4",
      "domain": "yourdomain.com",
      "verificationStatus": "verified",
      "spfStatus": "valid",
      "dkimStatus": "valid",
      "dmarcStatus": "valid",
      "isFullyVerified": true,
      "trackingSubdomain": "track",
      "useCustomTracking": false,
      "bounceSubdomain": "bounce",
      "useCustomBounce": false,
      "inboundEnabled": false,
      "inboundSubdomain": null,
      "mxVerified": false,
      "healthStatus": "healthy",
      "createdAt": "2026-02-17T10:00:00Z",
      "updatedAt": "2026-02-17T10:15:00Z"
    }
  ],
  "nextCursor": "eyJ2IjoxLCJzIjoiY3JlYXRlZGF0OmRlc2MiLCJrIjoi...",
  "hasMore": true
}

Domain abrufen

GET https://api.mail.land/v1/domains/{id}

Gibt die vollständigen Domain-Details zurück, einschließlich Verifizierungsstatus und aller Subdomains.

Get a domain
curl https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Domain-Einstellungen aktualisieren

Tracking- und Bounce-Subdomains anpassen und Inbound umschalten. Weitere Einstellungsfelder: useCustomTracking, useCustomBounce, inboundEnabled, inboundSubdomain. Diese Bezeichnungen wirken erst, wenn das jeweilige benutzerdefinierte Flag aktiviert und der Eintrag verifiziert ist. Das Aktivieren von useCustomBounce löscht die Verifizierung des Bounce-Eintrags, sodass Sie dessen CNAME erneut verifizieren müssen:

PATCH https://api.mail.land/v1/domains/{id}/settings
Update domain settings
curl -X PATCH https://api.mail.land/v1/domains/k3v9x2m8q1w7z4/settings \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "trackingSubdomain": "links",
    "bounceSubdomain": "returns"
  }'

Das Ändern von Subdomains erfordert eine Aktualisierung Ihrer DNS-Einträge und eine erneute Verifizierung der Domain.

Domain löschen

DELETE https://api.mail.land/v1/domains/{id}

Gibt bei Erfolg 204 No Content zurück. Das Löschen einer Domain:

  • Widerruft alle mit der Domain verknüpften DKIM-Schlüssel
  • Stoppt alle E-Mail-Versendungen von dieser Domain
  • Entfernt das Tracking- und Bounce-Routing
Delete a domain
curl -X DELETE https://api.mail.land/v1/domains/k3v9x2m8q1w7z4 \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Das Löschen ist dauerhaft. API-Anmeldedaten, die auf diese Domain beschränkt sind, können keine E-Mails mehr versenden. Aktive Kampagnen oder Automatisierungen, die diese Domain verwenden, werden fehlschlagen.

Fehlerantworten

StatusCodeBeschreibung
400VALIDATION_FAILEDUngültiges Domainnamen-Format
400INVALID_REQUESTDomain bereits hinzugefügt (zu diesem Workspace oder einem anderen)
400DOMAIN_SUBDOMAIN_EMPTYPATCH-Einstellungen: ein Subdomain-Feld wurde leer gesendet
400DOMAIN_SUBDOMAIN_CONFLICTPATCH-Einstellungen: die angeforderte Subdomain wird bereits von einem anderen Eintrag dieser Domain verwendet
404DOMAIN_NOT_FOUNDDomain-ID existiert nicht
403PLAN_LIMIT_REACHEDMaximale Anzahl von Domains für Ihren Plan erreicht

MailLand begrenzt die Anzahl der Versanddomains je nach Plan, und das Limit unterscheidet sich pro Plan (manche Pläne sind unbegrenzt). Ist es erreicht, liefert das Hinzufügen einer Domain 403 PLAN_LIMIT_REACHED. Ihren aktuellen Plan finden Sie unter Abrechnung.

Nächste Schritte

Geplante E-Mails

E-Mails für zukünftige Zustellung mit Zeitzonen-Unterstützung planen

DNS-Einrichtung

SPF-, DKIM- und DMARC-Einträge für Ihre Sendedomain konfigurieren

Auf dieser Seite

Domain hinzufügenAntwortEinrichtungsablaufDomain hinzufügenDNS-Anweisungen abrufenDNS-Einträge konfigurierenDomain verifizierenDomains auflistenDomain abrufenDomain-Einstellungen aktualisierenDomain löschenFehlerantwortenNächste Schritte