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" }
await fetch('https://www.obanox.com/api/v1/your-newsletter/send', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'API-KEY': process.env.OBANOX_API_KEY,
'API-SECRET': process.env.OBANOX_API_SECRET,
},
body: JSON.stringify({
from: '[email protected]',
to: '[email protected]',
subject: 'Reset your password',
text: 'Here is your link: …',
}),
});
// 202 Accepted
{ "id": 4711, "status": "queued" }
$ch = curl_init('https://www.obanox.com/api/v1/your-newsletter/send');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'API-KEY: ' . getenv('OBANOX_API_KEY'),
'API-SECRET: ' . getenv('OBANOX_API_SECRET'),
],
CURLOPT_POSTFIELDS => json_encode([
'from' => '[email protected]',
'to' => '[email protected]',
'subject' => 'Reset your password',
'text' => 'Here is your link: …',
]),
]);
curl_exec($ch);
// 202 Accepted
{ "id": 4711, "status": "queued" }
requests.post(
"https://www.obanox.com/api/v1/your-newsletter/send",
headers={
"API-KEY": os.environ["OBANOX_API_KEY"],
"API-SECRET": os.environ["OBANOX_API_SECRET"],
},
json={
"from": "[email protected]",
"to": "[email protected]",
"subject": "Reset your password",
"text": "Here is your link: …",
},
timeout=10,
)
# 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.
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
Domain bestätigen
Setz die DNS-Einträge aus deinem Konto und beantrage die Versandfreigabe. Wir antworten meist innerhalb weniger Stunden.
-
2
API-Schlüssel erstellen
Benannte Schlüssel, jeder einzeln widerrufbar. Derselbe Schlüssel und dasselbe Secret funktionieren auch für SMTP.
-
3
Erste E-Mail versenden
POST an /send oder SMTP-Daten in dein Framework eintragen. Dann siehst du sie im Protokoll erscheinen.
Dein Newsletter läuft im selben Konto
Dieselbe Domain, dieselbe Sperrliste, derselbe API-Schlüssel. Wenn du mehr brauchst als transaktionale E-Mails, ist es schon da.
POST /add-subscriberAbonnentenTrag Anmeldungen aus deiner App in deinen Newsletter ein, mit Double-Opt-in.
POST /postsBeiträgeMach aus Inhalten deines CMS Ausgaben: als Entwurf, sofort oder geplant.
MCPMCP-ServerLass Claude, ChatGPT oder Cursor eine E-Mail versenden oder einen Newsletter-Entwurf schreiben.
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.