zasend-node

Official Node.js client for the zaSend transactional email API.

zaSend is a developer-focused email delivery service for sending product, auth, billing, notification, and lifecycle emails from your application. This package is a small wrapper around the zaSend REST API for Node.js, Next.js, Express, NestJS, background jobs, and scripts.

Use it to:

• Send transactional email from verified domains
• Send template-based email with variables
• Check message status and events
• Manage suppressions, webhooks, templates, and domains
• Verify zaSend webhook signatures

The client stays close to the raw API. It has no runtime dependencies and uses the built-in fetch available in Node 18+.

Install

npm install zasend-node

Quick Start

const { ZaSend } = require("zasend-node");

const zasend = new ZaSend(process.env.ZASEND_API_KEY);

const result = await zasend.sendEmail({
  from: "zaSend <noreply@zasend.com>",
  to: "user@example.com",
  subject: "Welcome",
  text: "Thanks for signing up.",
});

console.log(result.message_id);

You can use an Account API Key (sk_live_...) for all methods. A Domain Sending Key (dsk_live_...) is restricted to sending email from one verified domain.

Send HTML Email

await zasend.sendEmail({
  from: "Acme <noreply@acme.com>",
  to: "customer@example.com",
  subject: "Your receipt",
  html: "<h1>Thanks for your order</h1><p>Your receipt is attached.</p>",
  text: "Thanks for your order. Your receipt is attached.",
});

Send to Multiple Recipients

await zasend.sendEmail({
  from: "Acme <noreply@acme.com>",
  to: ["one@example.com", "two@example.com"],
  subject: "Product update",
  text: "A new update is available.",
});

zaSend returns one queued message per to recipient. Suppressed recipients reject the whole request so you can fix the list before sending.

Template Send

await zasend.sendTemplateEmail({
  from: "Acme <noreply@acme.com>",
  to: "customer@example.com",
  template: "welcome",
  variables: { name: "Ada" },
});

Next.js / Express Example

const { ZaSend } = require("zasend-node");

const zasend = new ZaSend(process.env.ZASEND_API_KEY);

async function sendSignupEmail(email) {
  return zasend.sendTemplateEmail({
    from: "Acme <noreply@acme.com>",
    to: email,
    template: "welcome",
    variables: { product: "Acme" },
  });
}

Webhook Verification

zaSend signs webhook payloads with HMAC-SHA256. Verify the raw request body before trusting webhook data.

const { verifyWebhookSignature } = require("zasend-node");

const ok = verifyWebhookSignature(
  request.rawBody,
  process.env.ZASEND_WEBHOOK_SECRET,
  request.headers["x-zasend-signature"]
);

API Methods

Method	Description
sendEmail(message)	Send direct content or a template email
sendTemplateEmail(options)	Convenience wrapper for template sends
getEmail(messageId)	Fetch email status and events
getRateLimits()	Fetch daily usage and limits
listDomains() / addDomain(domain) / verifyDomain(id) / deleteDomain(id)	Manage sending domains
listSuppressions(options) / addSuppression(email, options) / deleteSuppression(id)	Manage suppression list entries
listWebhooks() / createWebhook(url, events) / deleteWebhook(id)	Manage signed delivery webhooks
listTemplates() / createTemplate(template) / getTemplate(id) / updateTemplate(id, template) / deleteTemplate(id)	Manage email templates

Error Handling

const { APIError, RateLimitError, ValidationError, ZaSend } = require("zasend-node");

try {
  await new ZaSend(process.env.ZASEND_API_KEY).sendEmail({
    from: "Acme <noreply@acme.com>",
    to: "user@example.com",
    subject: "Hello",
    text: "Body",
  });
} catch (error) {
  if (error instanceof RateLimitError) {
    console.log("Rate limited:", error.message);
  } else if (error instanceof ValidationError) {
    console.log("Invalid request:", error.message);
  } else if (error instanceof APIError) {
    console.log("zaSend API error:", error.message);
  } else {
    throw error;
  }
}

Links

• Website: zasend.com
• API documentation: zasend.com/docs
• Source: GitHub

License

MIT