Mail-API · by WebXIO
SMTP-Relay nimmt die Mails Ihrer Anwendung per REST-API entgegen, füllt die Vorlage in der richtigen Sprache und stellt sie über Ihr eigenes Mailkonto zu: Microsoft 365, Google oder jeder SMTP-Server. Mit Warteschlange, Wiederholungen und Protokoll, betrieben von WebXIO in Europa.
Request
curl -X POST https://admin.smtp.webxio.at/api/v1/send \
-H "Authorization: Bearer $SMTP_RELAY_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "anna@example.com",
"templateId": 7,
"language": "de-AT",
"variables": { "firstName": "Anna" }
}'Antwort
HTTP/1.1 202 Accepted
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
{ "id": 42, "status": "queued", "language": "de" }01Ablauf
Ihre Anwendung schickt einen Request, den Rest erledigt das Relay: prüfen, rendern, einreihen, zustellen.
Schickt Empfänger, Vorlage und Variablen als JSON, authentifiziert mit dem API-Key ihres Projekts.
Bearer srk_…Key, Rate-Limit und Inhalt werden geprüft. Sobald die Mail in der Warteschlange liegt, antwortet die API mit einer ID.
202 AcceptedDie Vorlage wird in der passenden Sprache gerendert: genau diese, dann die Basissprache, dann Englisch, dann Deutsch.
HandlebarsBis zu 5 Versuche mit wachsenden Pausen. Dauerhafte Fehler wie ein unbekannter Empfänger werden nicht wiederholt.
BullMQ · ValkeyVersendet wird über das SMTP-Konto Ihres Projekts: Microsoft 365, Google oder jeder andere Server, auf Wunsch per SSL, TLS oder STARTTLS.
SMTPDer Status wechselt auf „sent“, mit Message-ID und Zeitpunkt. Abrufbar per API und im Protokoll.
status: sentVersendet wird über Ihr eigenes Konto: Absenderadresse, SPF und DKIM bleiben bei Ihrem Mailanbieter.
02Funktionen
Was Ihre Anwendung sonst selbst bauen müsste, steckt im Relay und lässt sich im Admin-UI verwalten.
Betreff, HTML und Text mit Platzhaltern, Bedingungen und Schleifen. Im Admin-UI mit visuellem Editor und Live-Vorschau.
Bis zu 50 Übersetzungen pro Vorlage. Sie schicken die Sprache mit, das Relay wählt die passende Übersetzung.
Jede Mail landet zuerst in der Warteschlange. Schlägt der Versand fehl, versucht es das Relay bis zu 5-mal.
Mehrere SMTP-Konten pro Projekt, eines davon als Standard. Pro Mail lässt sich mit accountId ein anderes wählen.
Jedes Projekt bekommt eigene, benannte Keys, etwa für Produktion und Test. Widerrufen geht mit einem Klick.
Jede Mail mit Status, Versuchen und letztem Fehler, filterbar nach Projekt, Status und Freitext.
Noch nicht verfügbar, aber vorgesehen:
03API
Ein POST mit JSON genügt, aus jeder Sprache und jedem Framework. Den Status jeder Mail fragen Sie mit ihrer ID ab.
templateId, variables und optional language. Inhalt und Übersetzungen pflegen Sie im Admin-UI, Ihr Code bleibt schlank.
subject plus html und/oder text direkt im Request, für Mails, deren Inhalt Ihre Anwendung selbst erzeugt.
Den API-Key nur serverseitig verwenden, nie im Browser.
curl …/api/v1/messages/42 Status abfragen
{
"id": 42,
"status": "sent",
"attempts": 2,
"language": "de",
"messageId": "<5f1c…@example.com>",
"sentAt": "2026-09-29T09:14:03.000Z",
"error": null
}04Betrieb
Das Relay ist auf Nachvollziehbarkeit gebaut: Jede angenommene Mail hat eine ID, einen Status und einen Verlauf.
Die API antwortet erst, wenn die Mail sicher in der Warteschlange liegt. Sonst gibt es 503, und Ihre Anwendung weiß Bescheid.
SMTP-Passwörter liegen AES-256-GCM-verschlüsselt in der Datenbank, API-Keys nur als SHA-256-Hash.
Jeder Benutzer sieht nur seine eigenen Mailkonten, Vorlagen und Projekte.
Versendet wird über Ihr eigenes Mailkonto. Absenderadresse, Reputation, SPF und DKIM bleiben bei Ihrem Anbieter.
Betrieben von WebXIO auf eigener Infrastruktur in Europa, gebaut und ausgeliefert über das eigene GitLab.
Das Relay verschickt seine eigenen Anmelde-Mails über sich selbst, ebenso die Kontaktformulare von webxio.at und dieser Seite.
Ein schlanker Stack aus erprobten, offenen Bausteinen.
05FAQ
Ehrliche Antworten auf die häufigsten Fragen.
Nein. Es gibt keinen Port, an den sich Mailprogramme verbinden. Ihre Anwendung spricht eine HTTPS-API, das Relay versendet dann über ein SMTP-Konto.
Ja, versendet wird über ein SMTP-Konto, etwa Microsoft 365, Google Workspace oder das Ihres Hosters. Wenn Sie noch keines haben, wählen Sie im Formular „Beratung gewünscht“.
Noch nicht. Die Einträge gehören zu Ihrer Domain und Ihrem Mailanbieter, der die Mails signiert. Eigene DKIM-Unterstützung ist in Planung.
Noch nicht. Alle drei sind in Planung, ebenso Öffnungs- und Klick-Tracking. Bis dahin fragen Sie den Zustellstatus per GET /api/v1/messages/:id ab.
Nicht nötig: Ein HTTP-Request genügt, aus jeder Sprache. Das Admin-UI zeigt für jedes Projekt einen fertigen curl-Aufruf.
Pro Projekt standardmäßig 60 Mails pro Minute, höchstens 100. Dazu kommen die Grenzen Ihres Mailanbieters: Microsoft 365 erlaubt zum Beispiel 30 pro Minute.
Nein. Ohne Abmeldelinks und Bounce-Handling ist das Relay für Transaktions-Mails gedacht: Bestätigungen, Benachrichtigungen, Kontaktformulare.
Über das Formular unten. Konten legt bei uns ein Mensch an, eine Selbstregistrierung gibt es nicht. Danach richten Sie Mailkonto, Vorlagen und Projekt im Admin-UI ein, auf Wunsch gemeinsam mit uns.
06Zugang
Konten legt bei uns ein Mensch an, kein Automat. Schreiben Sie kurz, wofür Sie das Relay brauchen.