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
| Sintoma | Solução |
|---|---|
Invalid login | API key ausente ou errada — confira se a variável de ambiente foi carregada e não tem espaços sobrando. |
ETIMEDOUT | O host bloqueia a porta SMTP — tente 587/465 ou mude para a API REST. |
| Cai no Spam | Confira 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.