AutoSend Node.js SDK

The official Node.js SDK for the AutoSend API.

Installation

npm install autosendjs

or

yarn add autosendjs

Setup

First, get your API key from the AutoSend Dashboard.

import { Autosend } from "autosendjs";

const autosend = new Autosend("as_xxxxxxxxxxxx");

Usage

Send an email with plain text

import { Autosend } from "autosendjs";

const autosend = new Autosend("as_xxxxxxxxxxxx");

await autosend.emails.send({
  from: { email: "[email protected]" },
  to: { email: "[email protected]" },
  subject: "Hello World",
  text: "Welcome to Autosend!",
});

Send an email with HTML

import { Autosend } from "autosendjs";

const autosend = new Autosend("as_xxxxxxxxxxxx");

await autosend.emails.send({
  from: { email: "[email protected]" },
  to: { email: "[email protected]" },
  subject: "Hello World",
  html: "<strong>Welcome to Autosend!</strong>",
});

Send bulk emails

import { Autosend } from "autosendjs";

const autosend = new Autosend("as_xxxxxxxxxxxx");

await autosend.emails.bulk({
  from: { email: "[email protected]" },
  subject: "Hello",
  html: "<p>Welcome!</p>",
  recipients: [
    { email: "[email protected]" },
    { email: "[email protected]" },
  ],
});

Personalize with dynamic data

Use {{variable}} placeholders in your email body and provide a dynamicData object to fill them in. Placeholders work in a raw html body, in templateId templates, and inside HTML attributes such as href="{{unsubscribeURL}}". They are supported by both emails.send and emails.bulk.

With emails.bulk, pass a dynamicData object per recipient to personalize a single body for each one:

await autosend.emails.bulk({
  from: { email: "[email protected]" },
  subject: "Your weekly report",
  html: '<p>Hi {{name}}!</p><a href="{{unsubscribeURL}}">Unsubscribe</a>',
  recipients: [
    {
      email: "[email protected]",
      dynamicData: { name: "Ada", unsubscribeURL: "https://app.example.com/u/abc" },
    },
    {
      email: "[email protected]",
      dynamicData: { name: "Linus", unsubscribeURL: "https://app.example.com/u/def" },
    },
  ],
});

Send a React email

Pass a React Email element as react and the SDK renders it to HTML for you. This requires the optional @react-email/render dependency:

npm install @react-email/render

import { Autosend } from "autosendjs";
import { WelcomeEmail } from "./emails/welcome";

const autosend = new Autosend("as_xxxxxxxxxxxx");

await autosend.emails.send({
  from: { email: "[email protected]" },
  to: { email: "[email protected]" },
  subject: "Welcome",
  react: <WelcomeEmail name="Ada" />,
});

The react field is also supported on emails.bulk. The element is rendered once, while per-recipient values are still applied from each recipient's dynamicData — keep {{...}} placeholders in your component for those. If both html and react are set, html takes precedence.

Manage contacts

import { Autosend } from "autosendjs";

const autosend = new Autosend("as_xxxxxxxxxxxx");

// Create a contact
await autosend.contacts.create({
  email: "[email protected]",
  firstName: "John",
  lastName: "Doe",
  listIds: ["list_abc123"],
  customFields: { company: "Acme", plan: "pro" },
});

// Get a contact
await autosend.contacts.get("contact_id");

// Update or create a contact
await autosend.contacts.upsert({
  email: "[email protected]",
  firstName: "Jane",
});

// Delete a contact
await autosend.contacts.delete("contact_id");

Configuration Options

const autosend = new Autosend("as_xxxxxxxxxxxx", {
  baseUrl: "https://api.autosend.com/v1", // Custom API endpoint
  timeout: 30000, // Request timeout in ms
  maxRetries: 3, // Number of retry attempts
  debug: false, // Enable debug logging
});

Retryable errors (HTTP 429 and 5xx) are retried up to maxRetries times with exponential backoff. Set maxRetries: 1 to disable retries — for example, a cron job that should halt on throttling rather than wait it out. When a request fails, the emails.send and emails.bulk responses include the HTTP statusCode (such as 429) so you can handle it accordingly.

Resend Adapter

AutoSend provides a drop-in replacement adapter for the Resend API:

import { Resend } from "autosendjs/resend";

const resend = new Resend("as_xxxxxxxxxxxx");

await resend.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Hello World",
  html: "<strong>It works!</strong>",
});

// Render a React Email element (requires @react-email/render):
await resend.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Welcome",
  react: <WelcomeEmail name="Ada" />,
});

// Rate-limited responses surface as error.name === "rate_limit_exceeded":
const { data, error } = await resend.emails.send({ /* ... */ });
if (error?.name === "rate_limit_exceeded") {
  // back off and retry later
}

// Create a contact
await resend.contacts.create({
  email: "[email protected]",
  firstName: "John",
  properties: { company: "Acme" },
});

// Get a contact
await resend.contacts.get("contact_id");

// Update a contact (by email)
await resend.contacts.update({
  email: "[email protected]",
  firstName: "Jane",
});

// Remove a contact
await resend.contacts.remove("contact_id");

You can also use the RESEND_API_KEY environment variable:

import { Resend } from "autosendjs/resend";

const resend = new Resend(); // Uses RESEND_API_KEY env var

License

MIT License