Schnellstart

Voraussetzungen

Ein MailLand-Konto (registrieren)
Eine verifizierte Absenderdomain
Ein API Key (Credential)

Sandbox-Zugangsdaten benötigen weiterhin eine registrierte, verifizierte Absenderdomain. Sie stellen nie an gewöhnliche Empfänger zu: Ein Sandbox-Versand wird angenommen und protokolliert oder nur an Adressen Ihrer Sandbox-Zulassungsliste (Einstellungen → Sandbox Allow List) zugestellt. Neue Workspaces sind bis zur Verifizierung auf diese Zulassungsliste beschränkt.

Ihre erste E-Mail versenden

API Key abrufen

Nachdem Sie Ihr Konto und Ihren Workspace erstellt haben, öffnen Sie in der Seitenleiste Credentials und erstellen Sie ein neues Credential:

Product: Sending
Mode: Production (oder Sandbox zum Testen)
Stream: Transactional
Channel: API

Kopieren Sie den API Key, er wird nur einmal angezeigt. Der Schlüssel sieht folgendermaßen aus:

ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

Das Präfix kodiert den Credential-Typ:

ml_: alle MailLand-Schlüssel beginnen damit
p oder s: Production- oder Sandbox-Modus
e, i oder v, Sending/E-Mail-, Inbound- oder Validation-Produkt (Sending-Schlüssel tragen zusätzlich einen Stream-Buchstaben: et für transaktional, em für Marketing, z. B. ml_pet_...)

E-Mail senden

Senden Sie eine POST-Anfrage an den Sende-Endpoint mit Ihren E-Mail-Details:

E-Mail mit curl senden

curl -X POST https://api.mail.land/v1/transactional/send \
  -H "X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": {
      "email": "[email protected]",
      "name": "Your App"
    },
    "to": [
      {
        "email": "[email protected]",
        "name": "Jane Doe"
      }
    ],
    "subject": "Welcome to our platform",
    "htmlContent": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "textContent": "Welcome! Thanks for signing up."
  }'

Antwort prüfen

Eine erfolgreiche Antwort gibt 202 Accepted mit Details zur eingereihten E-Mail zurück:

Antwort: 202 Accepted

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "messageIds": ["t_a1b2c3d4e5f6..."],
  "acceptedRecipients": ["[email protected]"],
  "rejectedRecipients": [],
  "queuedAt": "2026-02-17T10:30:00Z",
  "isSandboxed": false
}

Wichtige Felder:

jobId: Eindeutiger Bezeichner zur Verfolgung dieses Sendevorgangs
messageIds: Individuelle Nachrichten-IDs (Präfix t_ für transaktional, m_ für Marketing)
acceptedRecipients: E-Mail-Adressen, die zur Zustellung angenommen wurden
rejectedRecipients: E-Mail-Adressen, die abgelehnt wurden (mit Begründung)
isSandboxed: true, wenn die Anfrage ein Sandbox-Credential verwendet hat: Die E-Mail wurde protokolliert, aber nicht versendet, oder nur an Empfänger der Zulassungsliste versendet

Häufige Fehler

Status	Fehlercode	Bedeutung
`401`	`UNAUTHORIZED`	`X-API-Key` fehlt, ist ungültig, abgelaufen oder widerrufen
`422`	`DOMAIN_NOT_VERIFIED`	Die Absenderdomain ist nicht verifiziert
`429`	`RATE_LIMIT_EXCEEDED`	Zu viele Anfragen: prüfen Sie den `Retry-After`-Header
`429`	`QUOTA_EXCEEDED`	Monatliches Sendekontingent erreicht
`429`	`SENDING_BLOCKED`	Die Verifizierungsstufe Ihres Kontos erlaubt diesen Versand noch nicht, Verifizierung abschließen (Marketing benötigt Business-Verifizierung)
`403`	`SENDING_BLOCKED`	Der Versand ist für dieses Konto vollständig gesperrt. Wiederholen hilft nicht; wenden Sie sich an den Support

Alle Fehler geben einen JSON-Body mit den Feldern code und message zurück:

Fehlerantwort

{
  "code": "DOMAIN_NOT_VERIFIED",
  "message": "Domain is not verified",
  "timestamp": "2026-02-17T10:30:00Z",
  "traceId": "00-4bf92f3577b34da6a3ce929d0e0e4736-00f067aa0ba902b7-01"
}

Nächste Schritte

REST API-Referenz: Vollständige API-Dokumentation mit allen Feldern und Optionen
SMTP Relay: E-Mails über SMTP statt REST versenden
Domain-Einrichtung: Ihre Absenderdomain hinzufügen und verifizieren
API Keys: Credentials mit Ratenlimits und IP-Beschränkungen konfigurieren

Schnellstart

VoraussetzungenLink zum Abschnitt kopieren

Ihre erste E-Mail versendenLink zum Abschnitt kopieren

API Key abrufenLink zum Abschnitt kopieren

E-Mail sendenLink zum Abschnitt kopieren

Antwort prüfenLink zum Abschnitt kopieren

Häufige FehlerLink zum Abschnitt kopieren

Nächste SchritteLink zum Abschnitt kopieren