E-Mail senden

Übersicht

Erstellen Sie Schlüssel unter Konto → Domains → Ihre Domain → API, nachdem die DNS-Verifizierung abgeschlossen ist. Das vollständige Geheimnis wird einmal angezeigt – speichern Sie es sicher. Optionale SMTP-Anmeldedaten im selben Domains-Bereich unterliegen denselben Regeln für transaktionale E-Mails.

Nur transaktionale E-Mails

Unbox HTTP API (POST /v1/email) and optional SMTP submission are for transactional mail only — messages tied to an account action, purchase, or operational event. They are not a newsletter or marketing broadcast service.

Zulässige Verwendungen

• Kontoverifizierung, Passwortzurücksetzungen und Sicherheitswarnungen
• Bestellbestätigungen, Quittungen, Versandaktualisierungen und Zahlungsmitteilungen
• Benachrichtigungen, die durch ein bestimmtes Benutzer- oder Systemereignis ausgelöst werden
• Team- und Arbeitsbereichsnachrichten (Einladungen, Zuweisungen, interne Warnungen)

Unzulässige Verwendungen

• Newsletter, Werbekampagnen oder Broadcast-Marketing
• Kaltakquise oder E-Mails an gekaufte, gescrapte oder nicht zustimmende Listen
• Affiliate-Spam, Phishing oder irreführende Inhalte
• Jeglicher Versuch, Empfängerbeschränkungen, Ratenlimits oder Tarifkontingente zu umgehen

Raten- und Empfängergrenzen

Zum Schutz der Empfänger und der Zustellbarkeit unterliegt der ausgehende API- und SMTP-Verkehr den unten genannten Grenzen (zusätzlich zum monatlichen Ausgangskontingent Ihres Tarifs). Die Durchsetzung erfolgt live im Web-Komponisten, der HTTP-API und der SMTP-Übermittlung. Der Web-Komponist warnt ab 25 Empfängern pro Nachricht und blockiert Sendungen über 50.

Diese Regeln sind Teil unserer Richtlinie zur akzeptablen Nutzung. Die automatische Durchsetzung erfolgt live im Web-Komponisten, der HTTP-API und der SMTP-Übermittlung. Konten, die Marketing- oder Massen-E-Mails versenden oder die Sendeinfrastruktur anderweitig missbrauchen, können gedrosselt, gesperrt oder gekündigt werden.

Wir überwachen Zustellsignale. Anhaltende Bounce-Raten über 3 % oder Beschwerderaten über 0,1 % können eine vorübergehende Sendepause oder manuelle Überprüfung auslösen.

Vollständige Richtliniendetails finden Sie in unseren Nutzungsbedingungen, Datenschutzrichtlinie und DSGVO-Erklärung.

Authentifizierung

Senden Sie Ihren Domain-API-Schlüssel bei jeder Anfrage:

Authorization: Bearer ubk_live_xxxxxxxxxxxxxxxxxxxxxxxx

Alternativ verwenden Sie X-Api-Key: ubk_live_…. Schlüssel werden gehasht gespeichert; widerrufen oder rotieren Sie sie über das Domains-Dashboard.

Anfragekörper

JSON mit PascalCase-Feldnamen (From, To, …). camelCase-Aliasnamen werden ebenfalls akzeptiert.

Beispiel

{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}

Erfolgreiche Antwort

HTTP 200 mit JSON:

{
  "ErrorCode": 0,
  "Message": "OK",
  "MessageID": "0100018…-000000-…",
  "SubmittedAt": "2026-06-23T12:00:00.000Z",
  "To": "user@example.com"
}

Fehlerantworten

Fehler geben 4xx (oder 500 bei unerwarteten Fehlern) mit JSON zurück:

{
  "ErrorCode": 300,
  "Message": "TextBody or HtmlBody is required."
}

Beispiele

Ersetzen Sie you@yourdomain.com durch Ihr persönliches Postfach auf der Domain und verwenden Sie Ihren eigenen API-Schlüssel.

curl "https://api.unbox.im/v1/email" \
  -H "Authorization: Bearer ubk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "From": "you@yourdomain.com",
  "To": "user@example.com",
  "Subject": "Welcome",
  "TextBody": "Thanks for signing up.",
  "HtmlBody": "<p>Thanks for signing up.</p>",
  "ReplyTo": "you@yourdomain.com",
  "Tag": "welcome"
}'