Neuer Leitfaden: So wärmen Sie eine dedizierte IP auf, ohne Ihre Reputation zu gefährden. Jetzt lesen →
Anmelden
MigoSMTP
E-Mail-API

E-Mails per Code senden, tracken und verwalten

Eine REST API für Versand, Templates, Events und Reporting, mit Keys mit begrenztem Scope und klaren Fehlermeldungen.

Agent-ready: Ein MCP-Server lässt KI-Assistenten Mails sicher senden und prüfen.

Request
POST /v1/send
{ "from": "hello@example.com",
"to": "you@example.com",
"subject": "Hello" }
Response
202 Accepted
{ "id": "msg_[id]" }
Idempotency-Key unterstützt
202 Accepted
JSON
Idempotent
Senden mit einem einzigen JSON-AufrufAuthentifizieren Sie sich mit einem Bearer-Key, senden Sie einen kleinen JSON-Body und erhalten Sie sofort eine Message-ID zurück.
Schnellstart
cURL
Node
Python
PHP
Python
import migosmtp
c = migosmtp.Client("KEY")
c.send(to="you@example.com",
template="welcome")
Gesendet · 202
Typisierte SDKs
Open Source
Offizielle Bibliotheken für Ihren StackWählen Sie Node, Python, PHP oder Go. Dieselben wenigen Zeilen senden eine Nachricht und behandeln Fehler überall gleich.
Scopes für API-Keys
E-Mail sendenErlaubt
Events lesenErlaubt
Domains verwaltenNur Admins
Ratenlimit[n] Req/s
Least Privilege
Sicher rotieren
Keys mit genau dem Zugriff, den sie brauchenErstellen Sie einen Key pro Service, begrenzen Sie, was jeder darf, und widerrufen Sie einen, ohne die anderen anzufassen.
Ratenlimit
Traffic-Spitze
Die Queue glättet die Spitze
Nichts geht verloren
Backpressure
Kein Datenverlust
Lastspitzen souverän abfangenWenn der Traffic Ihre Rate übersteigt, werden Requests in die Queue gestellt und abgearbeitet statt abgelehnt, sodass nichts verloren geht.
Nachrichten-Events
Signierte Events
/events
200 OK
Data Warehouse
200 OK
Alarme
Neuversuch in 30 s
HMAC-signiert
At-least-once
Events kommen auf demselben Weg zurückDieselbe API-Oberfläche streamt Events zu Zustellung, Öffnung, Klick und Bounce signiert an Ihren Endpunkt zurück.
Mailen Sie die Rechnung an Priya und bestätigen Sie die Zustellung
KI-Agent
MigoSMTP MCPeingeschränkter Key
send_emailEine Nachricht senden
get_eventsZustellergebnisse lesen
check_domainDNS-Records prüfen
Gesendet · Request-ID protokolliert · Zustellung bestätigt
MCP bereit
Eingeschränkt und protokolliert
KI-Agenten Ihre API aufrufen lassenDieselbe API steht auch über MCP bereit, sodass ein Agent E-Mails senden, Events lesen und DNS prüfen kann. Keys sind eingeschränkt, Aufrufe werden protokolliert, und Sendungen können eine Freigabe erfordern.
Eine Anfrage
SDKs
Eingeschränkte Keys
Rate Limits
Webhooks
Agent-API
SMTP-RelayREST-APIWebhooksDedizierte IPsDKIM-SignierungInbound ParseTemplatesAnalyticsSuppression-ListenReputations-MonitoringE-Mail-ValidierungTeam-Rollen und Audit-LogSMTP-RelayREST-APIWebhooksDedizierte IPsDKIM-SignierungInbound ParseTemplatesAnalyticsSuppression-ListenReputations-MonitoringE-Mail-ValidierungTeam-Rollen und Audit-Log
Funktionen

Eine API, die sich in Produktion bewährt

REST-Endpunkte

Vorhersehbare Ressourcen für Nachrichten, Templates, Domains und Events.

Templates und Variablen

Per Template-Name senden und Variablen pro Nachricht übergeben.

Idempotency-Keys

Sicher wiederholen, ohne Duplikate zu versenden.

Eingeschränkte API-Keys

Jeder Service erhält nur die Berechtigungen, die er braucht.

Webhooks

Erhalten Sie signierte Events zu jedem Zustellergebnis.

Klare Fehler und Limits

Einheitliche Fehlercodes und Rate-Limit-Header.

So funktioniert es

Ihr ServiceRuft den Send-Endpunkt per HTTPS mit einem eingeschränkten API-Key auf.
MigoSMTP-E-Mail-APIPrüft die Anfrage, wendet Templates und Limits an, reiht die Nachricht ein und liefert eine ID zurück.
Events zurück an SieSignierte Webhooks melden Zustell-, Bounce- und Beschwerde-Ergebnisse an Ihre App.
SCHRITT 1

API-Key erstellen

Wählen Sie Scopes und eine IP-Allowlist für den Service, der ihn nutzt.

SCHRITT 2

Erste Nachricht senden

Rufen Sie den Send-Endpunkt mit verifiziertem Absender und einem Empfänger auf.

SCHRITT 3

Auf Events lauschen

Registrieren Sie einen Webhook, um Zustellung, Bounces und Engagement zu verfolgen.

In Aktion sehen

Eine Plattform vom ersten Versand bis zum Posteingang

Wechseln Sie zwischen den Phasen, um zu sehen, was Sie in jedem Schritt steuern. Beispielhafte Oberfläche. Alle gezeigten Zahlen und Adressen sind Beispieldaten.

app.migosmtp.com / sendBeispieldaten
In der Queue
184,320
Heute gesendet
6,418,905
Rate
412/s
angenommenNachricht an you@example.com
angenommenNachricht an team@example.com
in der QueueBatch mit 25.000 Empfängern
angenommenNachricht an ops@example.com
Für Entwickler

Versioniert, dokumentiert und leicht zu testen

Alles im Dashboard ist auch per API verfügbar, mit Beispielen in den Sprachen, die Sie nutzen.

  • Eingeschränkte Keys mit IP-Allowlist
  • Idempotente Anfragen für sichere Wiederholungen
  • Einheitliches Fehlerformat
  • SDKs und kopierfertige Beispiele
Auf einen Blick
Basis-URLapi.migosmtp.com/v1
AuthentifizierungBearer-API-Key
FormatJSON über HTTPS
EventsSignierte Webhooks
ReferenzVollständige API-Referenz und SDK-Beispiele
Überblick

Was ist eine E-Mail-API?

Eine E-Mail-API ist eine Web-Schnittstelle, über die Ihr Code E-Mails senden und verwalten kann, indem er HTTP-Endpunkte aufruft, statt SMTP zu sprechen. Mit der MigoSMTP-E-Mail-API senden Sie per POST eine JSON-Anfrage mit verifiziertem Absender, Empfänger und entweder Inhalt oder Template-Name, und die Nachricht wird über unsere MigoMTA-Infrastruktur zur Zustellung eingereiht. Die Antwort enthält eine Kennung zum Nachverfolgen. Sie können auch mit rohem HTTP senden.

Die API eignet sich für Produktteams, die vorhersehbare Ressourcen für Nachrichten, Templates, Domains und Events wünschen. Keys sind eingeschränkt, sodass ein Abrechnungs-Service Belege versenden kann, ohne Domains bearbeiten zu dürfen. Idempotency-Keys machen Wiederholungen sicher, und einheitliche Fehlercodes mit Rate-Limit-Headern ermöglichen es Clients, sauber zu drosseln. Alles im Dashboard ist auch per API verfügbar. Sandbox- und Produktivverkehr lassen sich über getrennte Workspaces und Keys trennen, damit Testsendungen nicht in Ihr Live-Reporting und Ihre Reputation einfließen.

Für die Zustellbarkeit bietet eine API Kontrolle, die SMTP nicht leisten kann: strukturierte Fehler, Metadaten pro Nachricht und Event-Webhooks, die Sie in Ihre Anwendung zurückspeisen können. In Kombination mit der Suppression-Verwaltung hören Sie automatisch auf, fehlerhafte Adressen anzuschreiben. Unser MCP-Server lässt KI-Agenten dieselbe API mit eingeschränkten, widerrufbaren Keys aufrufen, sodass die Automatisierung innerhalb Ihrer Grenzen bleibt. Da jeder Key eingeschränkt ist und protokolliert wird, sehen Sie genau, welcher Service oder Agent welche Nachricht gesendet hat, und können den Zugriff bei Bedarf sofort entziehen.

Anwendungsfälle

Typische Anwendungsfälle der E-Mail-API

Transaktions-E-Mails aus Ihrer App

Lösen Sie Belege, Passwort-Resets und Benachrichtigungen mit einem einzigen API-Aufruf aus. Senden Sie per Template-Name und übergeben Sie Variablen, damit Ihr Produktcode frei von HTML bleibt und Textänderungen keinen Code berühren.

Sichere Wiederholungen in Job-Queues

Hängen Sie jeder Sendung einen Idempotency-Key an. Stürzt ein Worker ab und wiederholt den Versand, erkennt die E-Mail-API das Duplikat und sendet dieselbe Nachricht nicht zweimal.

Keys pro Service in Microservices

Vergeben Sie pro Service einen eingeschränkten Key mit IP-Allowlist. Wird ein Service kompromittiert, widerrufen Sie nur diesen einen Key, und der Rest Ihrer E-Mail-Pipeline läuft weiter.

Den Kreis mit Events schließen

Kombinieren Sie den Send-Endpunkt mit Webhooks, damit Ihre Datenbank die Status zugestellt, gebounct und beschwert widerspiegelt. Support-Teams können dann beantworten, wohin eine E-Mail ging, ohne Logs zu öffnen.

Benachrichtigungen aus einem SaaS-Produkt

Senden Sie In-App-Ereignisse wie Einladungen, Nutzungswarnungen und Abrechnungshinweise über eine API, mit einem Key pro Service und Templates in der Hand des Produktteams.

Agenten und Automatisierung

Geben Sie einem KI-Agenten oder internen Tool einen eingeschränkten Key, der nur senden oder nur den Status lesen darf. Jeder Aufruf wird diesem Key zugeordnet protokolliert, sodass Sie nachvollziehen können, was er getan hat, und ihn jederzeit widerrufen können.

Die richtige Methode wählen

E-Mail-API oder SMTP-Relay?

Beide liefern über dieselbe Infrastruktur zu. Wählen Sie danach, wie Ihre Software aufgebaut ist.

E-Mail-APISMTP-Relay
Ideal fürNeuer Code, der Templates, Idempotenz und strukturierte Antworten nutzen willBestehende Apps, CMS-Plugins und Geräte, die bereits SMTP sprechen
IntegrationHTTPS und JSON aus jeder SpracheHost und Zugangsdaten in Ihren Mail-Einstellungen
FehlerStrukturierte Fehlercodes und Rate-Limit-HeaderSMTP-Antwortcodes
ZugriffskontrolleEingeschränkte API-Keys, optionale IP-AllowlistZugangsdaten pro Konto und IP-Allowlist

Sie können beides in einem Workspace nutzen: SMTP für Tools, die Sie nicht ändern können, und die API für neue Services.

KI-Funktionen

KI-gestützte E-Mail-API

Agent-ready

MCP-Server für KI-Agenten

Verbinden Sie einen KI-Assistenten über einen MCP-Server mit MigoSMTP, damit er den Nachrichtenstatus abfragen oder Sendungen vorbereiten kann. Keys tragen die Scopes, die Sie vergeben, und Sendungen können eine menschliche Freigabe erfordern.

Copilot

Copilot zur Fehleranalyse

Fügen Sie einen API-Fehler oder eine fehlgeschlagene Anfrage ein, und der Copilot erklärt die Ursache, etwa einen nicht verifizierten Absender oder ein fehlerhaftes Feld, und zeigt einen korrigierten Aufruf. Die Korrektur setzen Sie selbst um.

Assistent

KI-erstellter Integrationscode

Beschreiben Sie, was Sie senden möchten, und der Assistent erzeugt eine Beispielanfrage in Ihrer Sprache nach den Konventionen unseres SDK. Prüfen und testen Sie sie, bevor sie in Produktion geht.

Prognosebasiert

Erkennung von Spitzen und Missbrauch

Die Anomalieerkennung beobachtet die Senderate pro Key und meldet ungewöhnliche Schübe. Sie kann Ihr Team benachrichtigen oder vorschlagen, einen Key zu pausieren; automatische Aktionen aktivieren Sie nur freiwillig.

KI-Funktionen sind unterstützend und optional: Agenten handeln nur innerhalb der von Ihnen vergebenen Scopes, und Ihr Team behält die Kontrolle über Keys und Sendungen.

Best Practices

Best Practices für die E-Mail-API

Idempotency-Keys bei jeder Sendung nutzen

Erzeugen Sie pro logischer E-Mail einen stabilen Key, etwa Bestell-ID plus Ereignis. Wiederholungen nach Timeouts erzeugen dann nie doppelte Nachrichten.

Keys auf das Minimum beschränken

Geben Sie jedem Service nur die Berechtigungen, die er braucht, und ergänzen Sie eine IP-Allowlist, wo Adressen fest sind. Ein kleinerer Wirkungsradius erleichtert die Reaktion auf Vorfälle.

Rate-Limit-Header beachten

Lesen Sie die Limit-Header in jeder Antwort und drosseln Sie, bevor Sie ausgebremst werden. Exponentielles Backoff mit Jitter fängt Schübe ab, ohne die API zu überlasten.

Webhook-Signaturen prüfen

Prüfen Sie die Signatur jedes Events, bevor Sie ihm vertrauen. Rotieren Sie das Secret regelmäßig und sofort, falls es offengelegt worden sein könnte.

Nachrichten-ID speichern

Speichern Sie die vom Send-Aufruf zurückgegebene Kennung neben Ihrem eigenen Datensatz. So gelingen Support-Abfragen und der Abgleich von Events später problemlos.

Test und Live getrennt halten

Nutzen Sie für Staging und Produktion unterschiedliche Workspaces und Keys. Testfehler erreichen dann keine echten Empfänger und beeinflussen Ihre Reputation nicht.

FAQ

E-Mail-API: häufig gestellte Fragen

Brauchen Sie Hilfe bei Ihrer Integration? Unser Team prüft sie gern mit Ihnen, bevor Sie live gehen.

Was ist eine E-Mail-API?

Eine E-Mail-API ist eine Reihe von HTTP-Endpunkten, über die Ihre Software E-Mails senden und verwalten kann, ohne Mailserver zu betreiben. Sie senden eine JSON-Anfrage, der Anbieter reiht die Nachricht ein und stellt sie zu, und Sie erhalten Statusmeldungen über Antworten und Webhooks.

Wie sende ich eine E-Mail mit der MigoSMTP-API?

Erstellen Sie einen API-Key, verifizieren Sie eine Absender-Domain und senden Sie dann per POST JSON an den Send-Endpunkt, mit Absenderadresse, Empfänger und entweder Inhalt oder einem Template mit Variablen. Die Antwort liefert eine Nachrichten-ID zum Nachverfolgen. Die Felder finden Sie in der API-Referenz.

Was ist der Unterschied zwischen E-Mail-API und SMTP?

SMTP ist ein Protokoll, das bestehende Software bereits spricht, sodass keine Codeänderungen nötig sind. Eine API nutzt HTTPS und JSON und bietet dadurch strukturierte Fehler, Templates, Idempotenz und Metadaten. Beide nutzen dieselbe Zustellinfrastruktur, wählen Sie also danach, wie Ihre Anwendung aufgebaut ist.

Gibt es eine Sandbox zum Testen der E-Mail-API?

Nutzen Sie zum Testen einen separaten Workspace und API-Key, damit Testsendungen nicht in Ihr Live-Reporting und Ihre Absenderreputation einfließen. Teilen Sie einen Key nie zwischen Test- und Live-Versand. Sprechen Sie uns an, wenn Sie einen Testmodus für Ihr Konto benötigen.

Wie werden API-Rate-Limits angewendet?

Limits werden in den Antwort-Headern zurückgegeben, sodass Ihr Client die verbleibende Kapazität sieht und drosseln kann, bevor er ausgebremst wird. Die für Sie geltenden Werte hängen von Ihrem Tarif ab. Bauen Sie Clients, die die Header lesen und kontrolliert langsamer werden.

Kann ich E-Mails in Batches senden?

Die geltenden Batch-Optionen und Empfängerlimits Ihres Tarifs finden Sie in der API-Referenz. Senden Sie unabhängig von der Batch-Größe bei jeder Anfrage einen Idempotency-Key mit und beachten Sie die Rate-Limit-Header, damit ein Teilausfall ohne Duplikate wiederholt werden kann.

Was ist der MigoSMTP-MCP-Server?

Ein MCP-Server ist ein Standardweg, auf dem KI-Assistenten Tools aufrufen. Unserer lässt kompatible Agenten mit der E-Mail-API arbeiten, etwa um den Nachrichtenstatus zu prüfen, und zwar mit eingeschränkten Keys unter Ihrer Kontrolle. Sendungen können eine Freigabe durch eine Person erfordern.

Welche Sprachen und SDKs werden unterstützt?

Es ist eine REST-API über HTTPS, daher funktioniert jede Sprache, die HTTP-Anfragen stellen kann. Kopierfertige Beispiele und SDKs sind in der Dokumentation aufgeführt. Bewahren Sie API-Keys in Umgebungsvariablen oder einem Secret-Manager auf, nie im Quellcode.

In wenigen Minuten versenden.

Konto erstellen, Domain hinzufügen und die erste E-Mail senden.