Next.js

Send an email from a Next.js App Router route handler or server action with notix-js. The key stays on the server, so it never reaches the browser.

Prerequisites

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

1. 1

   Install the SDK

   npmpnpmyarnbunCopy

   npm install notix-js
   

2. 2

   Set your API key

   Add the key to .env.local. Do not prefix it with NEXT_PUBLIC_, or Next.js ships it to the browser.

   .env.localCopy

   NOTIX_API_KEY=notix_12345
   

3. 3

   Send from a route handler

   The route only sends to the signed-in customer, about their own order. auth and getOrder stand for your app's own sign-in and database code.

   app/api/send/route.tsCopy

   import { Notix } from "notix-js";
   import { auth } from "@/lib/auth"; // your sign-in library
   import { getOrder } from "@/lib/orders"; // your database code
   
   const notix = new Notix(process.env.NOTIX_API_KEY);
   
   export async function POST(request: Request) {
     // Anyone can call this URL. Check who is calling before you send anything.
     const session = await auth();
     if (!session?.user) return new Response("Sign in first", { status: 401 });
   
     const { orderId } = (await request.json()) as { orderId?: string };
     const order = orderId ? await getOrder(orderId) : null;
     if (!order || order.userId !== session.user.id) return new Response("Order not found", { status: 404 });
   
     const { data, error } = await notix.emails.send({
       from: "Acme <receipts@acme.com>",
       to: session.user.email, // from the session, never from the request body
       subject: `Your receipt for order ${order.number}`,
       html: "<p>Thanks for your order.</p>",
     });
   
     if (error) return Response.json({ error: "Could not send the receipt" }, { status: 502 });
     return Response.json({ emailId: data?.emailId });
   }
   

4. 4

   Or send from a server action

   A server action is a public endpoint. Check who is calling and never take the recipient straight from the client.

   app/actions.tsCopy

   "use server";
   
   import { Notix } from "notix-js";
   import { auth } from "@/lib/auth"; // your sign-in library
   import { getOrder } from "@/lib/orders"; // your database code
   
   const notix = new Notix(process.env.NOTIX_API_KEY);
   
   export async function sendReceipt(orderId: string) {
     const session = await auth();
     if (!session?.user) throw new Error("Sign in first");
   
     const order = await getOrder(orderId);
     if (!order || order.userId !== session.user.id) throw new Error("Order not found");
   
     const { data, error } = await notix.emails.send({
       from: "Acme <receipts@acme.com>",
       to: session.user.email, // looked up on the server
       subject: `Your receipt for order ${order.number}`,
       html: "<p>Thanks for your order.</p>",
     });
   
     if (error) throw new Error("Could not send the receipt");
     return data?.emailId;
   }
   

Next steps

• Send many emails at once with batch sending.
• Add files with attachments.
• Make retries safe with idempotency keys.
• Receive delivery events in a route handler with webhooks.