Send emails with Next.js

Call Apollo Signal from a Route Handler, Server Action, or other server-only module. Do not import the SDK into a Client Component. The client uses https://api.signal.apollodeploy.com by default. Before you start, create an API key with Emails: Send permission and verify the From domain.

Install the SDK

npm install @apollo-deploy/signal-sdk

Configure the server secret

Add SIGNAL_API_KEY to your deployment environment. Do not prefix it with NEXT_PUBLIC_.

Create a route handler

app/api/send-welcome/route.ts

import { ApolloSignalApi } from "@apollo-deploy/signal-sdk";

const signal = new ApolloSignalApi();

export async function POST(request: Request) {
  const { email } = (await request.json()) as { email: string };

  const message = await signal.emails.sendEmail(
    {
      from: "welcome@mail.company.com",
      to: [email],
      subject: "Welcome",
      text: "Your account is ready.",
    },
    {
      headers: {
        Authorization: `Bearer ${process.env.SIGNAL_API_KEY}`,
      },
    },
  );

  return Response.json({ id: message.id }, { status: 201 });
}

Validate and authorize the incoming request before accepting arbitrary recipients. Add rate limits when the route is reachable outside your trusted application flow.

All SDKs

Compare every supported language and framework.

API key safety

Keep credentials out of client bundles and logs.

Getting started

Dashboard

Emails

Contacts and consent

Insights

Domains

Webhooks

Settings

Migration

Send emails with Next.js

All SDKs

API key safety