Sendcorex
Tutorial

Cómo enviar correo con Node.js (Nodemailer y API REST)

Dos formas de hacerlo — Nodemailer por SMTP, o una simple llamada fetch a una API REST — con código que funciona y la configuración de DNS que te mantiene fuera de Spam.

Por el equipo de Sendcorex·Actualizado 21 sept 2026·9 min de lectura

Respuesta corta: para enviar correo con una API REST en Node.js, haz una petición POST con fetch (integrado en Node 18+) al endpoint de envío del proveedor, con tu API key en el encabezado Authorization y un cuerpo JSON con from, to, subject y html. No hace falta SDK — consulta la Opción 2 con el código completo.

Hay dos buenas formas de enviar correo desde Node.js: por SMTP con Nodemailer, o con una simple llamada fetch a una API REST. Node.js 18 o superior basta para ambas — también necesitarás una cuenta de Sendcorex y un dominio de envío verificado (publica los registros SPF, DKIM y DMARC que te da el panel antes de enviar nada real).

Opción 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);

Opción 2: API REST con fetch

Sin dependencias, funciona en entornos serverless y edge, donde el SMTP saliente suele estar bloqueado:

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}`);

Errores y reintentos

SíntomaSolución
Invalid loginAPI key ausente o incorrecta — comprueba que la variable de entorno se cargó y no tiene espacios de más.
ETIMEDOUTEl host bloquea el puerto SMTP — prueba 587/465 o cambia a la API REST.
Llega a SpamRevisa SPF/DKIM en un encabezado real de Gmail, envía text y html, aumenta el volumen poco a poco.

Las respuestas 4xx significan que la propia petición es incorrecta — no reintentes. 429 y 5xx son temporales — reintenta con backoff exponencial.

Preguntas frecuentes

¿Cómo envío correo usando una API REST en Node.js?

Llama al endpoint de envío del proveedor con fetch: haz un POST con un cuerpo JSON (from, to, subject, html) y pon tu API key en el encabezado Authorization. Node.js 18+ incluye fetch, así que no necesitas ningún paquete. Comprueba el estado de la respuesta y reintenta solo los errores 429 y 5xx.

¿Debo usar SMTP (Nodemailer) o una API REST?

Una API REST suele ser más rápida y te devuelve un ID de mensaje y códigos de error claros en la respuesta. SMTP con Nodemailer encaja mejor cuando una librería o framework ya espera SMTP. Ambos entregan igual.

¿Cómo hago seguimiento de los correos enviados en Node.js?

Guarda el ID de mensaje que devuelve la llamada de envío y usa webhooks (delivered, bounced, opened, clicked) o la API de registros de correo para seguir qué pasó con cada correo.

Envía tu primer correo en minutos

Crea una cuenta gratis, verifica tu dominio y pega el código de arriba.

Sin tarjeta de crédito