Sendcorex
Tutorial

Como enviar email com Node.js (Nodemailer e API REST)

Duas formas de fazer isso — Nodemailer via SMTP, ou uma simples chamada fetch para uma API REST — com código funcionando e a configuração de DNS que te mantém fora do Spam.

Pela equipe Sendcorex·Atualizado em 21 de set. de 2026·9 min de leitura

Resposta curta: para enviar email com uma API REST no Node.js, faça uma requisição POST com fetch (nativo no Node 18+) para o endpoint de envio do provedor, com sua API key no cabeçalho Authorization e um corpo JSON com from, to, subject e html. Não precisa de SDK — veja a Opção 2 com o código completo.

Há duas boas formas de enviar email a partir do Node.js: via SMTP com Nodemailer, ou com uma simples chamada fetch para uma API REST. Node.js 18 ou mais novo basta para as duas — você também vai precisar de uma conta Sendcorex e de um domínio de envio verificado (publique os registros SPF, DKIM e DMARC que o painel fornece antes de enviar qualquer coisa de verdade).

Opção 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);

Opção 2: API REST com fetch

Sem dependências, funciona em ambientes serverless e edge, onde o SMTP de saída costuma ser 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}`);

Erros e novas tentativas

SintomaSolução
Invalid loginAPI key ausente ou errada — confira se a variável de ambiente foi carregada e não tem espaços sobrando.
ETIMEDOUTO host bloqueia a porta SMTP — tente 587/465 ou mude para a API REST.
Cai no SpamConfira SPF/DKIM num cabeçalho real do Gmail, envie text e html, aumente o volume aos poucos.

Respostas 4xx significam que a própria requisição está errada — não tente de novo. 429 e 5xx são temporários — tente de novo com backoff exponencial.

Perguntas frequentes

Como envio email usando uma API REST no Node.js?

Chame o endpoint de envio do provedor com fetch: faça um POST com um corpo JSON (from, to, subject, html) e coloque sua API key no cabeçalho Authorization. O Node.js 18+ já tem fetch nativo, então você não precisa de nenhum pacote. Confira o status da resposta e tente de novo só em erros 429 e 5xx.

Devo usar SMTP (Nodemailer) ou uma API REST?

Uma API REST costuma ser mais rápida e devolve um ID de mensagem e códigos de erro claros na resposta. SMTP com Nodemailer é a melhor escolha quando uma biblioteca ou framework já espera SMTP. Os dois entregam do mesmo jeito.

Como acompanho os emails enviados no Node.js?

Guarde o ID de mensagem retornado pela chamada de envio e use webhooks (delivered, bounced, opened, clicked) ou a API de logs de email para acompanhar o que aconteceu com cada email.

Envie seu primeiro email em minutos

Crie uma conta grátis, verifique seu domínio e cole o código acima.

Sem cartão de crédito