Mail Sender docs Retour à l'application →

Démarrage rapide

De la création du compte au premier email envoyé, en cinq étapes.

1. Créer un compte et vérifier son adresse

Inscrivez-vous sur la page d'inscription. Un email de vérification vous est envoyé immédiatement : tant que vous n'avez pas cliqué sur le lien qu'il contient, les fonctions sensibles restent fermées, en particulier :

  • la création de clés API ;
  • l'ajout d'un compte SMTP personnel ;
  • le changement de forfait ;
  • la configuration des adresses IP autorisées.

À savoir

Vous n'avez pas reçu l'email ? Vérifiez le dossier « indésirables », puis demandez un nouvel envoi depuis la page de vérification.

2. Choisir le serveur d'envoi

Par défaut, votre compte utilise le compte SMTP système, partagé par tous les utilisateurs du forfait gratuit. C'est suffisant pour tester. Pour envoyer depuis votre propre domaine (et soigner votre délivrabilité), ajoutez votre propre compte SMTP : voir Ajouter un compte SMTP.

3. Créer une clé API

Rendez-vous sur Clés API, donnez un nom à la clé (par exemple « site vitrine » ou « facturation ») et choisissez le compte SMTP qu'elle utilisera.

Attention

La clé complète est affichée une seule fois, à sa création : seul son empreinte SHA-256 est conservée en base. Copiez-la immédiatement dans le gestionnaire de secrets de votre application. Si vous la perdez, révoquez-la et créez-en une nouvelle.

4. Envoyer un premier email

bash
curl -X POST "https://mailer.echange.online/api/send.php" \
  -H "X-API-Key: VOTRE_CLE_API" \
  -d "to=destinataire@example.com" \
  -d "from=vous@votredomaine.com" \
  -d "subject=Bonjour" \
  -d "body=Mon premier email envoyé par API."

Réponse attendue :

json
{
  "success": true,
  "message_id": "<9f2c...@votredomaine.com>",
  "format": "text",
  "template": null,
  "recipients": { "to": 1, "cc": 0, "bcc": 0 },
  "attachments": { "count": 0, "bytes": 0 },
  "quota": { "used": 1, "quota": 100 }
}

5. Vérifier l'envoi

Le tableau de bord liste vos derniers envois avec leur statut, le sujet, le nombre de destinataires et l'horodatage. En cas d'échec, le message d'erreur renvoyé par le serveur SMTP y est conservé : c'est le premier endroit où regarder.

Et ensuite ?