Ajouter un compte SMTP

Envoyez vos emails depuis votre propre serveur, avec votre propre nom de domaine.

Pourquoi un compte SMTP personnel ?

Le compte système fourni par défaut est partagé : il permet de tester immédiatement, mais l'adresse d'expédition réelle ne vous appartient pas. Avec votre propre compte SMTP :

vos messages partent de votre domaine, ce qui améliore nettement la délivrabilité ;
vous maîtrisez la réputation d'envoi et vos enregistrements SPF/DKIM/DMARC ;
vous pouvez router chaque clé API vers un serveur différent (transactionnel, notifications…).

Forfait requis

Le nombre de comptes SMTP personnels autorisés dépend de votre forfait. Le forfait gratuit n'en autorise aucun et utilise le compte système ; les forfaits payants en autorisent de 1 à 100. Voir Quotas et limites.

Ce qu'il vous faut

Ces informations sont fournies par votre hébergeur email (OVH, Gandi, Google Workspace, Microsoft 365, Brevo, Mailgun…) :

Champ	Description	Exemple
Nom	Libellé libre, pour vous y retrouver dans la liste.	Boîte transactionnelle
Serveur (host)	Le nom d'hôte du serveur SMTP sortant.	`smtp.monfournisseur.com`
Port	587 avec STARTTLS, ou 465 en SSL/TLS implicite.	`587`
Chiffrement	`STARTTLS` (port 587) dans la majorité des cas, `SSL/TLS implicite` (port 465) chez certains hébergeurs.	STARTTLS
Identifiant	Souvent l'adresse email complète du compte.	`envoi@mondomaine.com`
Mot de passe	Le mot de passe du compte, ou un « mot de passe d'application » si votre fournisseur en propose (recommandé).	—
Adresse d'expédition	L'adresse utilisée comme enveloppe SMTP (`MAIL FROM`). Elle doit être autorisée par votre fournisseur.	`contact@mondomaine.com`

Étape par étape

Ouvrez la page Comptes SMTP.
Remplissez le formulaire « Ajouter un compte SMTP personnel » avec les valeurs ci-dessus.
Cliquez sur « Tester la connexion » : l'application se connecte au serveur, négocie le chiffrement puis s'authentifie avec vos identifiants, sans envoyer d'email ni enregistrer le compte. En cas d'échec, le message indique l'étape qui a échoué.
Enregistrez : le mot de passe est chiffré en base (AES-256-GCM) et n'est plus jamais réaffiché.
Allez sur Clés API et créez une clé en sélectionnant ce compte SMTP dans la liste déroulante.
Envoyez un email de test avec cette clé (voir Démarrage rapide).

À savoir

Le rattachement compte SMTP ↔ clé API se fait à la création de la clé. Pour faire passer une application d'un serveur d'envoi à un autre, créez une nouvelle clé rattachée au nouveau compte, déployez-la, puis révoquez l'ancienne.

Adresse « From » visible et enveloppe SMTP

Le paramètre from de l'API définit l'adresse affichée dans le client mail du destinataire. L'enveloppe SMTP réellement utilisée (MAIL FROM) reste, elle, l'adresse d'expédition du compte SMTP rattaché à la clé.

Ce choix est délibéré : il empêche le service de se comporter comme un relais ouvert et évite les rejets anti-usurpation. En pratique, utilisez un from appartenant au même domaine que votre compte SMTP — sinon certains destinataires afficheront une mention du type « envoyé via… », voire classeront le message en indésirable.

Vérifier que tout fonctionne

bash

curl -X POST "https://mailer.echange.online/api/send.php" \
  -H "X-API-Key: CLE_RATTACHEE_AU_NOUVEAU_COMPTE" \
  -d "to=votre-adresse-perso@example.com" \
  -d "from=contact@mondomaine.com" \
  -d "subject=Test compte SMTP" \
  -d "body=Si vous lisez ceci, le compte SMTP est correctement configuré."

En cas d'échec, l'API renvoie un code 502 avec le message brut du serveur SMTP. Les causes les plus fréquentes :

Message	Cause probable
`535 Authentication failed`	Identifiant ou mot de passe incorrect, ou mot de passe d'application requis.
`Connexion SMTP impossible`	Host ou port erroné, ou port bloqué en sortie par votre hébergeur.
`Échec de la négociation STARTTLS`	Mauvais type de chiffrement : essayez SSL/TLS implicite sur le port 465.
`550 Sender address rejected`	L'adresse d'expédition n'est pas autorisée par votre fournisseur.

Supprimer un compte SMTP

La suppression est refusée tant qu'une clé API l'utilise : révoquez d'abord les clés concernées, puis supprimez le compte. Cette protection évite de casser silencieusement une intégration en production.