Node.js Quickstart

Send your first email with the Mailofly TypeScript SDK. Requires: Node.js 18+ · API key · Account key

1. Install

npm install @mailofly/node

2. Send an email

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

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

const { id } = await client.emails.send({
  from: "Acme <onboarding@example.com>",
  to: ["you@example.com"],
  subject: "Hello from Mailofly",
  html: "<p>It works!</p>",
  account_key: process.env.MAILOFLY_ACCOUNT_KEY,
});

console.log("Sent:", id);

3. Check mail logs

Open Emails or call:

await client.mailLogs.list({ page: 1, page_size: 10 });

Next.js App Router & CLI Automations

Use the Mailofly CLI to quickly scaffold an automated background API route in your Next.js project. This creates a type-safe automation handler compatible with Vercel and Mailofly’s scheduling engine:

npx @mailofly/cli generate nextjs-route my-email-handler

You can then import this handler and invoke it directly from your React Server Actions or as a REST endpoint to queue emails asynchronously without blocking the client.

Next