MailLandDocs
Erste Schritte

Kontoeinrichtung

Erstellen Sie Ihr Mail.Land-Konto, verifizieren Sie Ihre E-Mail-Adresse und richten Sie Ihren ersten Workspace ein

Konto erstellen

Registrieren

Senden Sie eine POST-Anfrage an den Registrierungs-Endpoint oder registrieren Sie sich über das Dashboard unter app.mail.land.

register.sh
curl -X POST https://api.mail.land/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-secure-password",
    "fullName": "Jane Doe",
    "companyName": "Acme Inc"
  }'

Die Felder fullName und companyName sind optional, werden jedoch empfohlen. Ihr Passwort muss 8 bis 128 Zeichen lang sein und einen Groß- und einen Kleinbuchstaben, eine Ziffer und ein Sonderzeichen enthalten.

E-Mail-Adresse verifizieren

Nach der Registrierung sendet MailLand einen Verifizierungscode an Ihre E-Mail-Adresse. Sie erhalten ein verificationTicket in der Registrierungsantwort:

Registration Response
{
  "requiresEmailVerification": true,
  "verificationTicket": "vt_abc123...",
  "maskedEmail": "y***@company.com"
}

Übermitteln Sie den Code aus Ihrem Posteingang:

verify-email.sh
curl -X POST https://api.mail.land/v1/auth/verify-email-ticket \
  -H "Content-Type: application/json" \
  -d '{
    "ticket": "vt_abc123...",
    "code": "482916"
  }'

Falls Sie den Code nicht erhalten haben, fordern Sie über POST /v1/auth/resend-verification-ticket einen neuen an. Zwischen Wiederholungsanfragen gilt eine Wartezeit und es gibt ein Tageslimit.

Anmelden

Nach der Verifizierung melden Sie sich an, um Ihr Zugriffstoken zu erhalten:

login.sh
curl -X POST https://api.mail.land/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "your-secure-password"
  }'
Login Response
{
  "userId": "abc123def456",
  "email": "[email protected]",
  "fullName": "Jane Doe",
  "accessToken": "eyJhbGciOiJIUzI1NiIs...",
  "refreshToken": "rt_abc123...",
  "expiresAt": "2026-02-17T11:30:00Z",
  "tenantCount": 1,
  "activeTenantId": "k3m9x2p7qw4rtz",
  "activeTenantName": "Acme Inc"
}

Wenn die Zwei-Faktor-Authentifizierung aktiviert ist, enthält die Antwort requiresTwoFactor: true und eine twoFactorChallengeId anstelle von Tokens.

Workspaces (Tenants)

Jedes MailLand-Konto verfügt über mindestens einen Workspace (auch Tenant genannt). Workspaces isolieren Ihre Domains, Zugangsdaten, Templates und Versanddaten voneinander.

Wann mehrere Workspaces sinnvoll sind

  • Getrennte Umgebungen: Produktion vs. Staging
  • Getrennte Produkte: wenn Sie mehrere Anwendungen betreiben, die E-Mails versenden
  • Getrennte Kunden: wenn Sie eine Agentur sind, die E-Mail-Marketing für mehrere Kunden verwaltet

Workspace wechseln

Verwenden Sie Ihr Zugriffstoken, um zwischen Workspaces zu wechseln. tenantId ist die öffentliche String-ID des Workspace, IDs erhalten Sie über GET /v1/account/tenants:

switch-tenant.sh
curl -X POST https://api.mail.land/v1/account/tenants/switch \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "k3m9x2p7qw4rtz"
  }'

Dieser Vorgang gibt ein neues, auf den ausgewählten Workspace beschränktes Zugriffstoken zurück.

Zwei-Faktor-Authentifizierung

MailLand unterstützt TOTP-basierte Zwei-Faktor-Authentifizierung (kompatibel mit Google Authenticator, Authy, 1Password usw.).

2FA aktivieren

  1. Rufen Sie POST /v1/auth/2fa/setup auf, um ein TOTP-Secret und einen QR-Code-URI zu erhalten
  2. Scannen Sie den QR-Code mit Ihrer Authentifizierungs-App
  3. Bestätigen Sie die Einrichtung durch Übermittlung eines gültigen Codes über POST /v1/auth/2fa/enable

Nach der Aktivierung ist bei jeder Anmeldung ein 6-stelliger Code aus Ihrer Authentifizierungs-App erforderlich.

Bewahren Sie Ihre Wiederherstellungscodes an einem sicheren Ort auf. Wenn Sie den Zugang zu Ihrer Authentifizierungs-App verlieren, sind die Wiederherstellungscodes die einzige Möglichkeit, den Zugang wiederherzustellen.

API-Authentifizierung

MailLand verwendet zwei Authentifizierungsmethoden:

Bearer-Tokens (Dashboard und Kontoverwaltung)

Für Kontooperationen (Anmeldung, Workspace-Verwaltung, Einstellungen) verwenden Sie JWT-Bearer-Tokens im Authorization-Header:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Tokens laufen nach der in expiresAt angegebenen Dauer ab. Verwenden Sie POST /v1/auth/refresh-token, um vor dem Ablauf ein neues Token zu erhalten.

API-Schlüssel (E-Mail-Operationen)

Für den E-Mail-Versand, die Domain-Verwaltung und alle operativen API-Aufrufe verwenden Sie API-Schlüssel im X-API-Key-Header:

X-API-Key: ml_pet_Ab3Kx9mN2pQ7rT4wL8yD...

API-Schlüssel sind auf einen Workspace beschränkt und laufen nicht ab, sofern Sie kein Ablaufdatum festlegen. Weitere Informationen zur Erstellung und Verwaltung von Zugangsdaten finden Sie unter API Keys.

Nächste Schritte

Schnellstart

Versenden Sie Ihre erste E-Mail mit Mail.Land in unter 5 Minuten

API-Schlüssel

Erstellen, konfigurieren und verwalten Sie API-Credentials mit feingranularer Zugriffskontrolle

Auf dieser Seite

Konto erstellenRegistrierenE-Mail-Adresse verifizierenAnmeldenWorkspaces (Tenants)Wann mehrere Workspaces sinnvoll sindWorkspace wechselnZwei-Faktor-Authentifizierung2FA aktivierenAPI-AuthentifizierungBearer-Tokens (Dashboard und Kontoverwaltung)API-Schlüssel (E-Mail-Operationen)Nächste Schritte