npm install @mailofly/node

import { Mailofly, MailoflyError } from "@mailofly/node";

const client = new Mailofly({
  apiKey: process.env.MAILOFLY_API_KEY!, // Don't hardcode this!
});

try {
  const { id } = await client.emails.send({
    from: "Your App <hello@yourdomain.com>",
    to: ["friend@example.com"],
    subject: "Hey there!",
    html: "<p>This just sent from Mailofly. Pretty cool, right? 🚀</p>",
  });
  console.log("Sent! Email ID:", id);
} catch (e) {
  if (e instanceof MailoflyError) {
    console.error("Something broke:", e.status, e.error, e.detailMessage);
  }
  throw e;
}

await client.emails.send({
  from: "Your App <hello@yourdomain.com>",
  to: ["friend@example.com"],
  template: {
    id: "your-template-uuid",
    variables: { first_name: "Alex", promo_code: "WELCOME20" },
  },
});

await client.emails.send({
  from: "Your App <hello@yourdomain.com>",
  to: ["friend@example.com"],
  subject: "Your invoice is ready",
  html: "<p>See the attached PDF!</p>",
  tags: [{ name: "type", value: "invoice" }],
  headers: { "X-Custom-Ref": "inv_1234" },
  attachments: [{ filename: "invoice.pdf", content: "<base64-string>" }],
});

const { data } = await client.batch.send([
  {
    from: "Your App <hello@yourdomain.com>",
    to: ["alice@example.com"],
    subject: "Hi Alice!",
    html: "<p>Your personalized message here.</p>",
  },
  {
    from: "Your App <hello@yourdomain.com>",
    to: ["bob@example.com"],
    subject: "Hi Bob!",
    html: "<p>Bob's personalized message here.</p>",
  },
]);

console.log("All sent:", data.map(row => row.id));

import { Mailofly, MailoflyError } from "@mailofly/node";

try {
  await client.identities.list();
} catch (e) {
  if (e instanceof MailoflyError) {
    // e.status — the HTTP status code (400, 401, 429, etc.)
    // e.error — a short error code string
    // e.detailMessage — a readable explanation of what went wrong
    console.error(e.status, e.error, e.detailMessage);
  }
}