Integration

SMTP Relay with Nodemailer and NoticeAPI

If your app already sends with Nodemailer, NoticeAPI can become the SMTP relay without changing your mailer architecture. Use port 465 with implicit TLS, put your ntc_ API key in the password field, and keep the same logs and suppressions as REST sends.

Nodemailer transport
import nodemailer from "nodemailer";

const transport = nodemailer.createTransport({
  host: "smtp.noticeapi.com",
  port: 465,
  secure: true,
  auth: {
    user: "noticeapi",
    pass: process.env.NOTICEAPI_KEY,
  },
});

await transport.sendMail({
  from: "Acme <[email protected]>",
  to: "[email protected]",
  subject: "Your receipt",
  html: "<p>Thanks for your order.</p>",
});

Port 465 implicit TLS

Use smtp.noticeapi.com on port 465 with secure true. Do not configure STARTTLS for this endpoint.

API key password

The username is ignored; authenticate with an ntc_ API key as the SMTP password.

Same delivery trail

Relayed messages appear in NoticeAPI logs and email timelines alongside REST and SDK sends.

Same safety layer

Verified domains, quotas, suppressions, and deliverability autopilot still apply to SMTP mail.

How it works

From test send to production traffic.

1

Create an API key

Use any NoticeAPI API key as the SMTP password.

2

Configure Nodemailer

Set host, port 465, secure true, any username, and the API key password.

3

Send a sandbox test

Use [email protected] while checking that your app can connect and queue mail.

4

Verify production DNS

Production from addresses must use a verified sending domain.

Trust

SMTP compatibility without a separate email product

SMTP relay is a compatibility path for transactional app mail. Use REST when you need attachments, and use broadcasts for consent-based audience sends so unsubscribe handling is enforced.

Implementation links

Build with the shipped docs.

FAQ

Questions developers ask before switching email.

Does Nodemailer need STARTTLS?

No. Configure port 465 with secure true for implicit TLS.

Can I send attachments through SMTP?

Not today. SMTP attachments are dropped in v0. Use the REST send API for attachments.

Can I use SMTP for newsletters?

Use the broadcasts API for audience sends so unsubscribe links, List-Unsubscribe headers, and subscribed contact state are enforced.

Start free. Send production after your domain is ready.

Free includes 3,000 production emails per month, a 100/day production cap, and one verified sending domain.