Send your first email.

npm install sendridge

import { Sendridge } from "sendridge";

const sendridge = new Sendridge(process.env.SENDRIDGE_API_KEY);

const { id } = await sendridge.emails.send({
  from: "Acme <you@yourdomain.com>",
  to: "your-registered-email@example.com",
  subject: "Welcome aboard!",
  html: "<h1>Hello 👋</h1><p>Thanks for signing up.</p>",
});

console.log(`Queued email ${id}`);

Authorization: Bearer sr_xxxxxxxxxxxxxxxx

npm install sendridge

// ESM / TypeScript
import { Sendridge } from "sendridge";

// CommonJS
const { Sendridge } = require("sendridge");

const sendridge = new Sendridge(); // reads SENDRIDGE_API_KEY

const result = await sendridge.emails.send({
  from: "Acme Billing <billing@yourdomain.com>", // name shown in the inbox; domain must be verified
  to: ["a@example.com", "b@example.com"], // string or array, max 50
  subject: "Your invoice",
  html: "<p>Invoice attached below.</p>",
  text: "Invoice attached below.",        // plain-text alternative
  replyTo: "support@yourdomain.com",
  tags: { type: "invoice" },
  metadata: { invoiceId: "INV-2026-0042" },
});

// result:
// {
//   id: "665f1c2e9b1d2a0012345678",
//   status: "queued",
//   to: ["a@example.com", "b@example.com"],
//   from: "Acme Billing <billing@yourdomain.com>",
//   subject: "Your invoice",
//   createdAt: "2026-07-15T10:30:00.000Z"
// }

const email = await sendridge.emails.get("665f1c2e9b1d2a0012345678");

// email.status is one of:
// "queued" | "sending" | "sent" | "delivered" | "bounced" | "failed" | "complained"

console.log(email.status, email.openCount, email.clickCount);

const { data, pagination } = await sendridge.emails.list({ page: 1, limit: 20 });

for (const email of data) {
  console.log(email.id, email.subject, email.status);
}
// pagination: { page: 1, limit: 20, total: 132 }

import {
  SendridgeError,
  ValidationError,     // 400 — bad payload; err.details has field errors
  AuthenticationError, // 401 — missing / invalid / revoked / expired key
  PermissionError,     // 403 — e.g. sandbox or domain approval restriction
  NotFoundError,       // 404 — unknown email id
  RateLimitError,      // 429 — rate limit or quota exceeded
  ServerError,         // 5xx — Sendridge-side problem
  TimeoutError,        // request exceeded the timeout
  NetworkError,        // DNS / connection failure
} from "sendridge";

try {
  await sendridge.emails.send({ /* ... */ });
} catch (err) {
  if (err instanceof RateLimitError) {
    // back off, then try again
  } else if (err instanceof ValidationError) {
    console.error(err.message, err.details);
  } else if (err instanceof SendridgeError) {
    console.error(err.statusCode, err.message);
  } else {
    throw err;
  }
}

const sendridge = new Sendridge("sr_...", {
  baseUrl: "https://api.sendridge.com", // override for local dev or staging
  timeoutMs: 30_000,                    // per-request timeout (default 30s)
  maxRetries: 2,                        // GET-only automatic retries (default 2)
});

SENDRIDGE_API_KEY=sr_xxxxxxxxxxxxxxxx

// app/api/send/route.ts
import { Sendridge } from "sendridge";

const sendridge = new Sendridge(); // reads SENDRIDGE_API_KEY

export async function POST(request: Request) {
  const { email } = await request.json();

  const { id } = await sendridge.emails.send({
    from: "Acme <hello@yourdomain.com>",
    to: email,
    subject: "Welcome to Acme",
    html: "<p>Thanks for signing up.</p>",
  });

  return Response.json({ id });
}

// app/actions.ts
"use server";

import { Sendridge } from "sendridge";

const sendridge = new Sendridge();

export async function sendWelcome(formData: FormData) {
  const email = String(formData.get("email"));

  await sendridge.emails.send({
    from: "Acme <hello@yourdomain.com>",
    to: email,
    subject: "Welcome to Acme",
    html: "<p>Thanks for signing up.</p>",
  });
}

// nuxt.config.ts
export default defineNuxtConfig({
  runtimeConfig: {
    // Server-only. Set it with the NUXT_SENDRIDGE_API_KEY environment variable.
    sendridgeApiKey: "",
  },
});

NUXT_SENDRIDGE_API_KEY=sr_xxxxxxxxxxxxxxxx

// server/api/send.post.ts
import { Sendridge } from "sendridge";

export default defineEventHandler(async (event) => {
  const { email } = await readBody<{ email: string }>(event);
  const sendridge = new Sendridge(useRuntimeConfig(event).sendridgeApiKey);

  const { id } = await sendridge.emails.send({
    from: "Acme <hello@yourdomain.com>",
    to: email,
    subject: "Welcome to Acme",
    html: "<p>Thanks for signing up.</p>",
  });

  return { id };
});

Base URL:  https://api.sendridge.com
Auth:      Authorization: Bearer sr_xxxxxxxxxxxxxxxx

curl -X POST https://api.sendridge.com/v1/emails/send \
  -H "Authorization: Bearer $SENDRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "you@yourdomain.com",
    "to": "customer@example.com",
    "subject": "Welcome!",
    "html": "<h1>Hello</h1>"
  }'

{
  "data": {
    "id": "665f1c2e9b1d2a0012345678",
    "status": "queued",
    "to": ["customer@example.com"],
    "from": "you@yourdomain.com",
    "subject": "Welcome!",
    "createdAt": "2026-07-15T10:30:00.000Z"
  },
  "message": "Email queued for delivery"
}

curl https://api.sendridge.com/v1/emails/665f1c2e9b1d2a0012345678 \
  -H "Authorization: Bearer $SENDRIDGE_API_KEY"

{
  "data": {
    "_id": "665f1c2e9b1d2a0012345678",
    "to": ["customer@example.com"],
    "from": "you@yourdomain.com",
    "subject": "Welcome!",
    "status": "delivered",
    "openCount": 2,
    "clickCount": 1,
    "createdAt": "2026-07-15T10:30:00.000Z",
    "updatedAt": "2026-07-15T10:30:04.000Z"
  }
}

curl "https://api.sendridge.com/v1/emails?page=1&limit=20" \
  -H "Authorization: Bearer $SENDRIDGE_API_KEY"

{
  "error": "Validation Error",
  "message": "Invalid request data",
  "details": { "from": ["Invalid email"] }
}