Email API for
Next.js.

See the first send.

"use server";

import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: process.env.BIRD_API_KEY! });

export async function sendWelcome() {
  const msg = await bird.email.send({
    from: "onboarding@messagebird.dev",
    to: ["delivered@messagebird.dev"],
    subject: "Hello from Bird",
    html: "<p>My first Bird email.</p>",
  });

  console.log(msg.id, msg.status); // "em_…", "accepted"
  return { id: msg.id, status: msg.status };
}

Onboarding sender and sandbox recipient only. This page does not send an email or contain a key.

ZIP with the displayed request, setup notes and an empty key template. A sandbox code sample, not a complete application. SDK version in the sample: 0.67.0; review current maintained setup before adapting it.

import { sendWelcome } from "./actions/send-welcome";

export default function Home() {
  async function submit(): Promise<void> {
    "use server";
    await sendWelcome();
  }

  return (
    <form action={submit}>
      <button type="submit">Send sandbox email</button>
    </form>
  );
}

Runtime and installation.

Bird’s Next.js quickstart uses an App Router Server Action with TypeScript and @messagebird/sdk. Use Node.js 20.9+ for the maintained Next.js quickstart; the SDK alone requires Node.js 20.3+.

Choose where to send.

Choose a Server Action when a form already belongs to the App Router. Choose a route handler when another client needs an HTTP endpoint; validate and authorize that request before sending.

Track delivery and retries.

Validate submitted form data and enforce who may trigger a send. A server directive protects the key, but does not authorize the caller. A transport error or “send failed” log can leave acceptance unknown; reconcile the original operation before retrying.