Sendcorex
Tutoriel

Comment envoyer des e-mails avec Node.js (Nodemailer et API REST)

Deux façons de faire — Nodemailer en SMTP, ou un simple appel fetch à une API REST — avec du code fonctionnel et la configuration DNS qui vous garde hors du spam.

Par l'équipe Sendcorex·Mis à jour le 21 sept. 2026·9 min de lecture

Réponse courte : pour envoyer un e-mail avec une API REST en Node.js, faites une requête POST avec fetch (intégré à Node 18+) vers l'endpoint d'envoi du fournisseur, avec votre clé API dans l'en-tête Authorization et un corps JSON contenant from, to, subject et html. Aucun SDK nécessaire — voir l'Option 2 pour le code complet.

Il existe deux bonnes façons d'envoyer des e-mails depuis Node.js : en SMTP avec Nodemailer, ou avec un simple appel fetch à une API REST. Node.js 18 ou plus suffit dans les deux cas — il vous faudra aussi un compte Sendcorex et un domaine d'envoi vérifié (publiez les enregistrements SPF, DKIM et DMARC fournis par le tableau de bord avant tout vrai envoi).

Option 1 : Nodemailer (SMTP)

npm install nodemailer
import nodemailer from 'nodemailer';

const transporter = nodemailer.createTransport({
  host: 'smtp.sendcorex.com',
  port: 587,
  secure: false, // STARTTLS on 587
  auth: { user: process.env.SENDCOREX_API_KEY, pass: process.env.SENDCOREX_API_KEY },
});

const info = await transporter.sendMail({
  from: '"Your App" <hello@yourdomain.com>',
  to: 'customer@example.com',
  subject: 'Welcome!',
  text: 'You are in.',
  html: '<h1>You are in.</h1>',
});

console.log('Sent:', info.messageId);

Option 2 : API REST avec fetch

Aucune dépendance, fonctionne dans les environnements serverless et edge où le SMTP sortant est souvent bloqué :

const response = await fetch('https://graph.sendcorex.com/v3.0/emails', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.SENDCOREX_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    to: 'customer@example.com',
    from: 'hello@yourdomain.com',
    subject: 'Welcome!',
    html: '<h1>You are in.</h1>',
  }),
});

if (!response.ok) throw new Error(`Send failed: ${response.status}`);

Erreurs et réessais

SymptômeCorrection
Invalid loginClé API manquante ou erronée — vérifiez que la variable d'environnement est chargée et sans espace parasite.
ETIMEDOUTL'hébergeur bloque le port SMTP — essayez 587/465, ou passez à l'API REST.
Arrive en spamVérifiez SPF/DKIM dans un vrai en-tête Gmail, envoyez text et html, augmentez le volume progressivement.

Les réponses 4xx signifient que la requête elle-même est incorrecte — ne réessayez pas. 429 et 5xx sont temporaires — réessayez avec un backoff exponentiel.

Questions fréquentes

Comment envoyer un e-mail via une API REST en Node.js ?

Appelez l'endpoint d'envoi du fournisseur avec fetch : envoyez en POST un corps JSON (from, to, subject, html) et mettez votre clé API dans l'en-tête Authorization. Node.js 18+ intègre fetch, aucun paquet n'est donc nécessaire. Vérifiez le statut de la réponse et ne réessayez que les erreurs 429 et 5xx.

Faut-il utiliser SMTP (Nodemailer) ou une API REST ?

Une API REST est généralement plus rapide et renvoie un ID de message et des codes d'erreur clairs dans la réponse. SMTP avec Nodemailer convient mieux quand une bibliothèque ou un framework attend déjà du SMTP. Les deux livrent de la même façon.

Comment suivre les e-mails envoyés en Node.js ?

Enregistrez l'ID de message renvoyé par l'appel d'envoi, puis utilisez les webhooks (delivered, bounced, opened, clicked) ou l'API des journaux d'e-mails pour suivre ce qu'il est advenu de chaque e-mail.

Envoyez votre premier e-mail en quelques minutes

Créez un compte gratuit, vérifiez votre domaine et collez le code ci-dessus.

Sans carte bancaire