SNDR

Use SNDR for app-triggered email — receipts, sign-in mail, and other transactional sends — over HTTPS JSON. Wire SndrTransport into createMailer; do not call @rkiza/sndr from application code.

Quick start

import { createMailer } from "sently/mailer";
import { SndrTransport } from "sently/transports/sndr";

const mailer = await createMailer({
  transport: new SndrTransport({
    apiKey: process.env.SNDR_API_KEY!,
  }),
});

const result = await mailer.send({
  from: "hello@yourdomain.com",
  to: "customer@example.com",
  subject: "Welcome aboard",
  html: "<p>Thanks for joining us.</p>",
});

console.log(result.messageId); // e.g. em_…
console.log(result.response); // e.g. queued

Configuration

Message mapping

POST /v1/send is idempotent when Idempotency-Key is supplied.

Templates

Set a template with the x-sndr-template-id header (or defaultTemplateId on the transport). Pass template variables through data ({{ variable }} placeholders on SNDR).

import { SNDR_TEMPLATE_ID_HEADER } from "sently/transports/sndr";

await mailer.send({
  from: "hello@yourdomain.com",
  to: "customer@example.com",
  subject: "Welcome",
  headers: { [SNDR_TEMPLATE_ID_HEADER]: "tpl_welcome" },
  data: { name: "Ada" },
});

Verify and errors

verify() calls GET /v1/domains with the same Bearer key.

Failed HTTP responses throw SndrError (SentlyError) with the API error.message when present.

Webhooks

Import from sently/webhooks/sndr. Verify X-Sndr-Signature (t=…,v1=…) over the raw body, then parse.

See Webhooks for the HMAC details.

What sently covers vs SNDR platform

Troubleshooting

Contact & resources

Learn more

• Email channel — mailer options and send pipeline
• Webhooks — SNDR delivery events and signature verification
• Bundle size — why subpath imports stay small

Next