Für Entwickler

Versende E-Mails aus deiner App. Und sieh, was passiert.

Passwort-Resets, Anmeldebestätigungen, Benachrichtigungen: ein POST-Request oder deine SMTP-Einstellungen. Versendet von deiner eigenen Domain, mit E-Mail-Protokoll und automatischer Bounce-Sperre.

curl -X POST "https://www.obanox.com/api/v1/your-newsletter/send" \
  -H "Content-Type: application/json" \
  -H "API-KEY: $OBANOX_API_KEY" \
  -H "API-SECRET: $OBANOX_API_SECRET" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Reset your password",
    "text": "Here is your link: …"
  }'

# 202 Accepted
{ "id": 4711, "status": "queued" }

„Die Reset-E-Mail ist nie angekommen.“

Eine E-Mail zu versenden ist eine Zeile Code. Zu wissen, ob sie angekommen ist, und den Ruf deiner Domain sauber zu halten, kostet dich den Nachmittag.

DNS vor der ersten E-Mail

DKIM, SPF, eine Bounce-Domain, DMARC: Ist ein Eintrag falsch, landen deine E-Mails im Spam.

Bounces, die du nie siehst

Ein Tippfehler bei der Anmeldung, und du schickst weiter an ein Postfach, das es nicht gibt. Die Mailbox-Anbieter merken das.

Kein Nachweis, wenn der Support fragt

Wenn jemand sagt, es sei nichts angekommen, wühlst du dich durch Logs, statt kurz nachzusehen.

Alles rund um den Send-Aufruf

Du schreibst die E-Mail. Obanox kümmert sich um alles, was passiert, nachdem sie deine App verlassen hat.

POST /send

REST-API

Ein Empfänger pro Request, JSON rein, 202 zurück. E-Mails landen in der Warteschlange und gehen meist innerhalb von Sekunden raus.

SMTP

SMTP-Relay

Für Frameworks und Tools, die SMTP sprechen. Unterstützt auch Anhänge, Cc und Bcc.

DKIM · SPF · DMARC

Deine eigene Domain

E-Mails kommen von deiner Domain, mit DKIM signiert, mit eigener Bounce-Domain und DMARC-Berichten.

recipient_suppressed

Bounce-Sperre

Hard Bounces, Spam-Beschwerden und unzustellbare Adressen werden automatisch gesperrt.

sent · bounced · complaint

E-Mail-Protokoll

Jede E-Mail mit ihrem Status. Such nach Empfänger oder Betreff und öffne, was beim Nutzer angekommen ist.

awaiting_approval

Freigabe, wenn du willst

Halte E-Mails auf Wunsch zurück, bis jemand sie freigibt, z. B. während du eine neue Integration testest.

Absender-Domain

Deine Domain, richtig eingerichtet.

Füge deine Domain hinzu, und Obanox zeigt dir genau, welche DNS-Einträge du setzen musst. Es prüft sie selbstständig und sagt dir, sobald sie bestätigt sind.

  • DKIM-Signatur mit drei CNAME-Einträgen.
  • Eigene Bounce-Domain mit MX und SPF, damit SPF zu deiner Domain passt.
  • Ein DMARC-Eintrag und lesbare DMARC-Berichte: Sieh, wie Gmail, Outlook und andere deine Domain bewerten.
Mehr zur Zustellbarkeit

Fehler

Fehler, die dir sagen, was zu tun ist.

Jeder Fehler kommt als JSON mit Statuscode und klarer Meldung. Und die Regel für Wiederholungen ist einfach.

202
Angenommen und in der Warteschlange. Vorübergehende Probleme beim Empfänger werden für dich wiederholt.
4xx
Korrigiere den Request; ihn unverändert erneut zu senden, hilft nicht.
429 · 5xx
Die einzigen, bei denen sich ein späterer Versuch lohnt.

In drei Schritten zur ersten E-Mail

Kein SDK zu installieren. Wenn dein Stack einen HTTP-Request senden oder SMTP sprechen kann, kann es losgehen.

  1. 1

    Domain bestätigen

    Setz die DNS-Einträge aus deinem Konto und beantrage die Versandfreigabe. Wir antworten meist innerhalb weniger Stunden.

  2. 2

    API-Schlüssel erstellen

    Benannte Schlüssel, jeder einzeln widerrufbar. Derselbe Schlüssel und dasselbe Secret funktionieren auch für SMTP.

  3. 3

    Erste E-Mail versenden

    POST an /send oder SMTP-Daten in dein Framework eintragen. Dann siehst du sie im Protokoll erscheinen.

Fragen

Welchen Tarif brauche ich?

API und SMTP-Relay gehören zu diesen Tarifen: Pro, Business. Pro gibt es ab 24 € im Monat. Preise

API oder SMTP?

Nimm die API für eine E-Mail pro Request mit JSON-Antwort. Nimm SMTP, wenn dein Framework schon per SMTP versendet oder du Anhänge, Cc oder Bcc brauchst. Beide teilen sich Domains, Limits und Sperrliste.

Läuft der Versand synchron?

Nein. Eine 202 heißt: Die E-Mail wurde angenommen und steht in der Warteschlange. Sie geht meist innerhalb von Sekunden raus, und vorübergehende Probleme beim Empfänger werden automatisch wiederholt.

Was passiert, wenn eine Adresse bounct?

Hard Bounces, Spam-Beschwerden und unzustellbare Adressen werden automatisch gesperrt. Weitere E-Mails dorthin liefern recipient_suppressed zurück, damit deine App nach einer anderen Adresse fragen kann.

Zählen transaktionale E-Mails zu meinem Tarif?

Ja, zusammen mit deinen Newsletter-E-Mails. Bei 80 % und 100 % deiner monatlichen E-Mails bekommst du eine Nachricht.

Gibt es ein SDK?

Nein, und du brauchst auch keins: Es ist ein einzelner JSON-Request. Die Doku hat fertige Beispiele für cURL, PHP, Node.js und Python. Dokumentation der E-Mail-API

Bau das E-Mail-Feature. Spar dir die E-Mail-Infrastruktur.

REST-API, SMTP-Relay und E-Mail-Protokoll im Pro-Tarif, ab 24 € im Monat.