Nouveau guide : comment réchauffer une IP dédiée sans nuire à votre réputation. Lire maintenant →
MigoSMTP
API e-mail

Envoyez, suivez et gérez vos e-mails depuis votre code

Une API REST pour l'envoi, les modèles, les événements et le reporting, avec des clés à portée limitée et des erreurs claires.

Prêt pour les agents : un serveur MCP permet aux assistants IA d'envoyer et d'inspecter des e-mails en toute sécurité.

Requête
POST /v1/send
{ "from": "hello@example.com",
"to": "you@example.com",
"subject": "Hello" }
Réponse
202 Accepted
{ "id": "msg_[id]" }
Idempotency-Key pris en charge
202 Accepted
JSON
Idempotent
Envoyez avec un seul appel JSONAuthentifiez-vous avec une clé bearer, postez un petit corps JSON et recevez aussitôt un ID de message.
Démarrage rapide
cURL
Node
Python
PHP
Python
import migosmtp
c = migosmtp.Client("KEY")
c.send(to="you@example.com",
template="welcome")
Envoyé · 202
SDK typés
Open source
Des bibliothèques officielles pour votre stackChoisissez Node, Python, PHP ou Go. Les mêmes quelques lignes envoient un message et gèrent les erreurs de la même façon partout.
Portées des clés API
Envoyer des e-mailsAutorisé
Lire les événementsAutorisé
Gérer les domainesAdmins uniquement
Limite de débit[n] req/s
Moindre privilège
Rotation sécurisée
Des clés avec exactement les accès nécessairesCréez une clé par service, limitez ce que chacune peut faire et révoquez-en une sans toucher aux autres.
Limite de débit
Pic de trafic
La file lisse le pic
Rien n'est perdu
Contre-pression
Aucune perte de données
Absorbez les pics sans accrocQuand le trafic dépasse votre débit, les requêtes sont mises en file et écoulées au lieu d'échouer : rien n'est perdu.
événements de message
Événements signés
/events
200 OK
Entrepôt de données
200 OK
Alertes
Nouvel essai dans 30 s
Signé HMAC
Au moins une fois
Les événements reviennent de la même façonLa même API renvoie vers votre endpoint, signés, les événements de livraison, d'ouverture, de clic et de bounce.
Envoie la facture à Priya par e-mail et confirme la livraison
Agent IA
MigoSMTP MCPclé à portée limitée
send_emailEnvoyer un message
get_eventsLire les résultats de livraison
check_domainVérifier les enregistrements DNS
Envoyé · ID de requête journalisé · livraison confirmée
MCP prêt
À portée limitée et journalisé
Laissez des agents IA appeler votre APILa même API est disponible via MCP : un agent peut envoyer des e-mails, lire les événements et vérifier le DNS. Les clés ont une portée limitée, les appels sont journalisés et les envois peuvent exiger une approbation.
Une seule requête
SDK
Clés à portée limitée
Limites de débit
Webhooks
API pour agents
Relais SMTPAPI RESTWebhooksIP dédiéesSignature DKIMAnalyse des e-mails entrantsModèlesAnalytiqueListes de suppressionSupervision de la réputationValidation d'e-mailsRôles d'équipe et journal d'auditRelais SMTPAPI RESTWebhooksIP dédiéesSignature DKIMAnalyse des e-mails entrantsModèlesAnalytiqueListes de suppressionSupervision de la réputationValidation d'e-mailsRôles d'équipe et journal d'audit
Fonctionnalités

Une API fiable en production

Endpoints REST

Des ressources prévisibles pour les messages, modèles, domaines et événements.

Modèles et variables

Envoyez par nom de modèle et passez des variables pour chaque message.

Clés d'idempotence

Réessayez en toute sécurité sans envoyer de doublons.

Clés API à portée limitée

Donnez à chaque service uniquement les permissions dont il a besoin.

Webhooks

Recevez des événements signés pour chaque résultat de livraison.

Erreurs et limites claires

Codes d'erreur cohérents et en-têtes de limite de débit.

Fonctionnement

Votre serviceAppelle l'endpoint d'envoi en HTTPS avec une clé API à portée limitée.
API e-mail MigoSMTPValide la requête, applique les modèles et les limites, met le message en file et renvoie un ID.
Les événements vous reviennentDes webhooks signés remontent à votre app les résultats de livraison, de rebond et de plainte.
ÉTAPE 1

Créer une clé API

Choisissez les portées et une liste d'IP autorisées pour le service qui l'utilisera.

ÉTAPE 2

Envoyer votre premier message

Appelez l'endpoint d'envoi avec un expéditeur vérifié et un destinataire.

ÉTAPE 3

Écouter les événements

Enregistrez un webhook pour suivre les livraisons, les rebonds et l'engagement.

Voir en action

Une plateforme, du premier envoi à la boîte de réception

Passez d'une étape à l'autre pour voir ce que vous contrôlez à chacune. Interface illustrative. Tous les chiffres et adresses affichés sont des données d'exemple.

app.migosmtp.com / sendDonnées d'exemple
En file
184,320
Envoyés aujourd'hui
6,418,905
Débit
412/s
acceptémessage à you@example.com
acceptémessage à team@example.com
en filelot de 25 000 destinataires
acceptémessage à ops@example.com
Pour les développeurs

Versionnée, documentée et facile à tester

Tout ce qui est dans le tableau de bord est disponible via l'API, avec des exemples dans les langages que vous utilisez.

  • Clés à portée limitée avec liste d'IP autorisées
  • Requêtes idempotentes pour des nouvelles tentatives sûres
  • Format d'erreur cohérent
  • SDK et exemples prêts à copier
En un coup d'œil
URL de baseapi.migosmtp.com/v1
AuthentificationClé API Bearer
FormatJSON sur HTTPS
ÉvénementsWebhooks signés
RéférenceRéférence complète de l'API et exemples de SDK
Aperçu

Qu'est-ce qu'une API e-mail ?

Une API e-mail est une interface web qui permet à votre code d'envoyer et de gérer des e-mails en appelant des endpoints HTTP au lieu de parler SMTP. Avec l'API e-mail MigoSMTP, vous envoyez en POST une requête JSON avec un expéditeur vérifié, un destinataire et soit un contenu, soit un nom de modèle, et le message est mis en file pour livraison via notre infrastructure MigoMTA. La réponse contient un identifiant pour le suivre. Vous pouvez aussi envoyer en HTTP brut.

L'API convient aux équipes produit qui veulent des ressources prévisibles pour les messages, modèles, domaines et événements. Les clés ont une portée limitée : un service de facturation peut envoyer des reçus sans pouvoir modifier les domaines. Les clés d'idempotence sécurisent les nouvelles tentatives, et des codes d'erreur cohérents avec des en-têtes de limite de débit permettent aux clients de ralentir proprement. Tout ce qui est dans le tableau de bord est aussi disponible par API. Le trafic de test et de production peut être séparé grâce à des espaces de travail et des clés différents, ce qui garde les envois de test hors de vos rapports et de votre réputation.

Pour la délivrabilité, une API vous donne un contrôle que SMTP ne permet pas : erreurs structurées, métadonnées par message et webhooks d'événements que vous pouvez réinjecter dans votre application. Associée à la gestion des suppressions, elle vous évite d'écrire automatiquement à de mauvaises adresses. Notre serveur MCP permet aux agents IA d'appeler la même API avec des clés à portée limitée et révocables, afin que l'automatisation reste dans les limites que vous fixez. Comme chaque clé est limitée et journalisée, vous voyez exactement quel service ou agent a envoyé quel message et pouvez révoquer l'accès immédiatement si besoin.

Cas d'usage

Cas d'usage courants de l'API e-mail

E-mails transactionnels depuis votre app

Déclenchez reçus, réinitialisations de mot de passe et alertes en un seul appel d'API. Envoyez par nom de modèle et passez des variables : le code produit reste libre de HTML et de modifications de texte.

Nouvelles tentatives sûres dans les files de tâches

Joignez une clé d'idempotence à chaque envoi. Si un worker plante et réessaie, l'API e-mail reconnaît le doublon et n'envoie pas deux fois le même message.

Clés par service dans les microservices

Émettez une clé à portée limitée par service, avec une liste d'IP autorisées. Si un service est compromis, vous révoquez une seule clé et le reste de votre chaîne d'e-mails continue de fonctionner.

Boucler la boucle avec les événements

Combinez l'endpoint d'envoi avec des webhooks pour que votre base de données reflète les états livré, rebondi et plainte. Vos équipes support savent alors où est passé un e-mail sans ouvrir les logs.

Notifications d'un produit SaaS

Envoyez les événements in-app tels qu'invitations, alertes d'usage et avis de facturation via une seule API, avec une clé par service et des modèles gérés par l'équipe produit.

Agents et automatisation

Donnez à un agent IA ou à un outil interne une clé à portée limitée qui peut seulement envoyer ou seulement lire les statuts. Chaque appel est journalisé sur cette clé : vous pouvez revoir ce qu'elle a fait et la révoquer à tout moment.

Choisir une méthode

API e-mail ou relais SMTP ?

Les deux livrent via la même infrastructure. Choisissez selon la façon dont votre logiciel est conçu.

API e-mailRelais SMTP
Idéal pourNouveau code qui veut des modèles, de l'idempotence et des réponses structuréesApps existantes, plugins CMS et appareils qui parlent déjà SMTP
IntégrationHTTPS et JSON depuis n'importe quel langageHôte et identifiants dans vos paramètres de messagerie
ErreursCodes d'erreur structurés et en-têtes de limite de débitCodes de réponse SMTP
Contrôle d'accèsClés API à portée limitée, liste d'IP autorisées facultativeIdentifiants par compte et liste d'IP autorisées

Vous pouvez utiliser les deux dans un même espace de travail : SMTP pour les outils que vous ne pouvez pas modifier, et l'API pour les nouveaux services.

Fonctions IA

API e-mail assistée par IA

Prêt pour les agents

Serveur MCP pour agents IA

Connectez un assistant IA à MigoSMTP via un serveur MCP pour qu'il consulte le statut des messages ou prépare des envois. Les clés portent les portées que vous accordez, et les envois peuvent exiger une approbation humaine.

Copilote

Copilote de diagnostic d'erreurs

Collez une erreur d'API ou une requête échouée : le copilote en explique la cause, par exemple un expéditeur non vérifié ou un champ mal formé, et montre un appel corrigé. Vous appliquez la correction vous-même.

Assistance

Code d'intégration rédigé par IA

Décrivez ce que vous voulez envoyer et l'assistant génère un exemple de requête dans votre langage selon les conventions de notre SDK. Relisez-le et testez-le avant la production.

Prédictif

Détection de pics et d'abus

La détection d'anomalies surveille les débits d'envoi par clé et signale les pics inhabituels. Elle peut alerter votre équipe ou suggérer de suspendre une clé, et toute action automatique est une option que vous activez.

Les fonctions IA sont des assistants facultatifs : les agents n'agissent que dans les portées que vous accordez, et votre équipe garde le contrôle des clés et des envois.

Bonnes pratiques

Bonnes pratiques pour l'API e-mail

Utilisez des clés d'idempotence sur chaque envoi

Générez une clé stable par e-mail logique, par exemple l'ID de commande plus l'événement. Les nouvelles tentatives après un délai dépassé ne produisent alors jamais de doublons.

Limitez les portées des clés au minimum

Donnez à chaque service uniquement les permissions dont il a besoin et ajoutez une liste d'IP autorisées lorsque les adresses sont fixes. Un rayon d'impact réduit simplifie la réponse aux incidents.

Respectez les en-têtes de limite de débit

Lisez les en-têtes de limite dans chaque réponse et ralentissez avant d'être bridé. Un backoff exponentiel avec jitter absorbe les pics sans martyriser l'API.

Vérifiez les signatures des webhooks

Contrôlez la signature de chaque événement avant de lui faire confiance. Renouvelez le secret régulièrement, et immédiatement s'il a pu fuiter.

Stockez l'ID du message

Conservez l'identifiant renvoyé par l'appel d'envoi avec votre propre enregistrement. Cela simplifie ensuite les recherches du support et le rapprochement des événements.

Séparez test et production

Utilisez des espaces de travail et des clés différents pour la préproduction et la production. Les erreurs de test n'atteignent alors pas de vrais destinataires et n'affectent pas votre réputation.

FAQ

API e-mail : questions fréquentes

Besoin d'aide pour votre intégration ? Notre équipe peut la relire avec vous avant la mise en production.

Qu'est-ce qu'une API e-mail ?

Une API e-mail est un ensemble d'endpoints HTTP qui permet à votre logiciel d'envoyer et de gérer des e-mails sans exploiter de serveurs de messagerie. Vous envoyez une requête JSON, le fournisseur met le message en file et le livre, et vous recevez les mises à jour de statut via les réponses et les webhooks.

Comment envoyer un e-mail avec l'API MigoSMTP ?

Créez une clé API, vérifiez un domaine d'expéditeur, puis envoyez en POST du JSON à l'endpoint d'envoi avec une adresse d'expéditeur, un destinataire et soit un contenu, soit un modèle avec des variables. La réponse renvoie un ID de message que vous pouvez suivre. Consultez la référence de l'API pour les champs.

Quelle est la différence entre une API e-mail et SMTP ?

SMTP est un protocole que les logiciels existants parlent déjà, donc sans changement de code. Une API utilise HTTPS et JSON, ce qui apporte erreurs structurées, modèles, idempotence et métadonnées. Les deux utilisent la même infrastructure de livraison : choisissez selon la conception de votre application.

Existe-t-il un bac à sable pour tester l'API e-mail ?

Utilisez un espace de travail et une clé API distincts pour les tests, afin que les envois de test restent hors de vos rapports et de votre réputation d'expéditeur. Ne partagez jamais une clé entre test et production. Contactez-nous si vous avez besoin d'un mode test pour votre compte.

Comment les limites de débit de l'API s'appliquent-elles ?

Les limites sont renvoyées dans les en-têtes de réponse, pour que votre client voie la capacité restante et ralentisse avant d'être bridé. Les valeurs qui vous concernent dépendent de votre offre. Concevez des clients qui lisent les en-têtes et ralentissent en douceur.

Puis-je envoyer des e-mails par lots ?

Consultez la référence de l'API pour les options de lot et les limites de destinataires de votre offre. Quelle que soit la taille du lot, envoyez une clé d'idempotence avec chaque requête et respectez les en-têtes de limite de débit, afin de pouvoir réessayer après un échec partiel sans doublons.

Qu'est-ce que le serveur MCP de MigoSMTP ?

Un serveur MCP est un moyen standard pour les assistants IA d'appeler des outils. Le nôtre permet aux agents compatibles de travailler avec l'API e-mail, par exemple pour vérifier le statut d'un message, avec des clés à portée limitée que vous contrôlez. Les envois peuvent exiger l'approbation d'une personne.

Quels langages et SDK sont pris en charge ?

C'est une API REST sur HTTPS : tout langage capable d'émettre des requêtes HTTP convient. Des exemples prêts à copier et des SDK sont listés dans la documentation. Gardez les clés API dans des variables d'environnement ou un gestionnaire de secrets, jamais dans le code source.

Commencez à envoyer en quelques minutes.

Créez un compte, ajoutez votre domaine et envoyez votre premier e-mail.