Next.js

Send your first email from a Next.js app with the official `mailblastr` SDK. Install it, create a client with your API key, and call mb.emails.send(...) from server-side code — a Route Handler, a Server Action, or any API route.

npm install mailblastr

Prerequisites

Before you start, you will need:

• A MailBlastr API key.
• A verified domain to send from.

1. Set your API key

Store your API key in an environment variable in your project's .env.local. Never hardcode the key in source.

MAILBLASTR_API_KEY=mb_xxxxxxxxx

2. Send an email from a Route Handler

Create a route file under app/api/send/route.ts (App Router). It reads the key from process.env, sends with the SDK, and returns the created email's id.

// app/api/send/route.ts
import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr(process.env.MAILBLASTR_API_KEY);

export async function POST() {
  const { data, error } = await mb.emails.send({
    from: 'Acme <onboarding@yourdomain.com>',
    to: ['delivered@example.com'],
    subject: 'Hello world',
    html: '<strong>It works!</strong>',
  });

  if (error) return Response.json({ error }, { status: 400 });
  return Response.json(data);
}

3. Response

A successful send returns the created email's id. Retrieve it later with GET /emails/:id.

{
  "id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794"
}