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 <[email protected]>",
  to: "[email protected]",
  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 <[email protected]>",
  to: "[email protected]",
  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 <[email protected]>",
  to: ["[email protected]", "[email protected]"],
  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 <[email protected]>",
  to: "[email protected]",
  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 <[email protected]>",
    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 <[email protected]>",
    to: "[email protected]",
    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