Envoyez votre premier e-mail

Créez une clé, vérifiez un domaine et envoyez un message. La plupart des équipes envoient en moins d'une heure ; la seule étape lente est l'attente du DNS.

Avant de commencer

Il vous faut un compte MigoSMTP et un domaine que vous contrôlez, comme example.com. Envoyer depuis un sous-domaine tel que mail.example.com sépare vos e-mails marketing et produit de votre domaine principal, et c'est un bon choix par défaut.

1. Créer une clé API

Dans le tableau de bord, ouvrez Clés API et créez une clé avec la permission d'envoi. Donnez à chaque application sa propre clé pour pouvoir en révoquer une sans toucher aux autres. Stockez-la comme un secret, jamais dans le gestionnaire de versions.

export MIGOSMTP_KEY="YOUR_API_KEY"

2. Vérifier un domaine

Ajoutez votre domaine d'envoi dans le tableau de bord et publiez les enregistrements DNS affichés : SPF, DKIM et, de préférence, une politique DMARC. Les modifications DNS peuvent mettre du temps à se propager ; attendez que le statut du domaine indique Vérifié avant d'envoyer.

3. Envoyer un message

Appelez le endpoint d'envoi avec une adresse d'expéditeur sur votre domaine vérifié. Remplacez les adresses d'exemple par les vôtres.

curl -X POST https://api.migosmtp.com/v1/send \
  -H "Authorization: Bearer $MIGOSMTP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"hello@example.com","to":"you@example.com","subject":"Hello","text":"It works."}'

4. Vérifier le résultat

La réponse contient un identifiant de message. Utilisez-le pour retrouver le message et ses événements dans le tableau de bord, ou recevez-les dans votre propre système via des webhooks.

Vous préférez SMTP ?

Si votre application parle déjà SMTP, pointez-la plutôt vers l'hôte SMTP affiché dans votre tableau de bord. Aucun changement de code n'est nécessaire hormis les paramètres de connexion. Consultez le guide d'intégration SMTP.

Avant la mise en production

Vérifiez d'abord ceci : envoyez depuis un domaine vérifié, publiez un enregistrement DMARC, gérez les réponses 429 avec un backoff, abonnez-vous aux webhooks de rebond et de plainte pour cesser d'écrire aux adresses qui échouent, et gardez les clés API hors de votre dépôt.

Et ensuite ?

Lisez la référence de l'API pour chaque endpoint, configurez les webhooks pour les événements de livraison, et consultez les codes d'erreur et les limites de débit pour que votre intégration gère bien les échecs.