Nextmail for Claude Code

Send emailwith Claude Code.

Paste one prompt and Claude Code installs the SDK, keeps your key on the server and writes the send.

Prompt for Claude Code

Add transactional email to this app with Nextmail.

1. Install the TypeScript SDK with npm install @nextmail/sdk.
2. Read the API key from the NEXTMAIL_API_KEY environment variable, on the server only. Never send it to the browser and never commit it.
3. Write a sendEmail helper that calls init once, then nextmail.emails.send. Send from an address on a domain verified in Nextmail.
4. Keep the send in server code, next to the code that creates users.
5. Pass an idempotencyKey built from the event, such as welcome:<userId>, so a retry never sends twice.
6. Send a welcome email when someone signs up, and log the id that comes back.

SDK reference: https://nextmail.sh/docs/sdk

Change the sender and the trigger to fit your app. The rest is how Nextmail expects to be called.

Three steps,
then it sends.

01
Mint a key
Create a key that can send in Settings. The secret shows once.
02
Keep it secret
Put it in .env as NEXTMAIL_API_KEY and keep .env out of git.
03
Paste the prompt
Claude Code installs the SDK and writes the send. Read the change, then run it.

What it writes.
One route, one call.

A typical result. Claude Code may name the files differently.

lib/email.ts

1import { init, nextmail } from '@nextmail/sdk'2 3init({ apiKey: process.env.NEXTMAIL_API_KEY })4 5export async function sendWelcome(user: User) {6  const sent = await nextmail.emails.send({7    from: 'Acme <hello@acme.com>',8    to: user.email,9    subject: `Welcome, ${user.name}`,10    html: `<p>Thanks for signing up, ${user.name}.</p>`,11  }, {12    idempotencyKey: `welcome:${user.id}`,13  })14 15  console.log(sent.id)16}