npm install mailofly

import { Mailofly, MailoflyError } from "mailofly";

const client = new Mailofly({
  apiKey: process.env.MAILOFLY_API_KEY!,
});

try {
  const { id } = await client.emails.send({
    from: "Acme <onboarding@example.com>",
    to: ["alex@example.com"],
    subject: "Hello",
    html: "<p>Thanks for signing up.</p>",
    account_key: "acc_…",
  });
  console.log("Sent:", id);
} catch (e) {
  if (e instanceof MailoflyError) {
    console.error(e.status, e.error, e.detailMessage);
  }
  throw e;
}

await client.emails.send({
  from: "Acme <onboarding@example.com>",
  to: ["alex@example.com"],
  template: {
    id: "uuid-of-template",
    variables: { first_name: "Alex", promo_code: "SAVE20" },
  },
});

await client.emails.send({
  from: "Acme <onboarding@example.com>",
  to: ["alex@example.com"],
  subject: "Your invoice",
  html: "<p>See attached.</p>",
  tags: [{ name: "category", value: "billing" }],
  headers: { "X-Entity-Ref-ID": "123" },
  attachments: [{ filename: "invoice.pdf", content: "<base64>" }],
});

const { data, has_more } = await client.emails.list({ limit: 20 });
const email = await client.emails.get("4ef9a417-02e9-4d39-ad75-9611e0fcc33c");

const { data } = await client.batch.send([
  {
    from: "Acme <onboarding@example.com>",
    to: ["foo@example.com"],
    subject: "hello world",
    html: "<h1>it works!</h1>",
  },
  {
    from: "Acme <onboarding@example.com>",
    to: ["bar@example.com"],
    subject: "world hello",
    html: "<p>it works!</p>",
  },
]);
console.log(data.map((row) => row.id));

// List sending accounts
const { data: accounts } = await client.accounts.list();

// Create a contact
await client.contacts.create({
  email: "alex@example.com",
  first_name: "Alex",
  custom_fields: { plan: "pro" },
});

// Send a campaign now
await client.campaigns.send("campaign-uuid", { send_now: true });

// Query failed mail logs
const logs = await client.mailLogs.list({
  status: "failed",
  page: 1,
  page_size: 50,
});

const meta = await Mailofly.discovery();
console.log(meta.resources);

import { Mailofly, MailoflyError } from "mailofly";

try {
  await client.accounts.list();
} catch (e) {
  if (e instanceof MailoflyError) {
    // e.status — HTTP status
    // e.error — error code string
    // e.detailMessage — human-readable message
  }
}