Resend Email API Node SDK

What's Changed

• feat(webhooks): add suppression webhooks by @Cisneiros in https://github.com/resend/resend-node/pull/1031
• chore: remove tegami release process by @gabrielmfern in https://github.com/resend/resend-node/pull/1033
• fix: remove object field from suppression list entry type by @felipefreitag in https://github.com/resend/resend-node/pull/1032
• fix(deps): update react monorepo to v19.2.8 by @renovate[bot] in https://github.com/resend/resend-node/pull/1036
• chore: bump version to 6.18.1 by @Cisneiros in https://github.com/resend/resend-node/pull/1038

Full Changelog: https://github.com/resend/resend-node/compare/v6.18.0...v6.18.1

nodejs-og

<p align="center">

<a href="https://resend.com/docs/send-with-nodejs">Quickstart Docs</a>

</p>

<p align="center">

Framework guides

</p>

<p align="center">

<a

• <a href="https://resend.com/docs/send-with-nextjs">Next.js</a>
• <a href="https://resend.com/docs/send-with-remix">Remix</a>
• <a href="https://resend.com/docs/send-with-nuxt">Nuxt</a>
• <a href="https://resend.com/docs/send-with-express">Express</a>
• <a href="https://resend.com/docs/send-with-redwoodjs">RedwoodJS</a>
• <a href="https://resend.com/docs/send-with-hono">Hono</a>
• <a href="https://resend.com/docs/send-with-bun">Bun</a>
• <a href="https://resend.com/docs/send-with-astro">Astro</a>

</p>

Resend Node.js SDK

Node.js library for the Resend API.

Install

npm install resend
# or
yarn add resend

Examples

Send email with:

• Node.js
• Next.js (App Router)
• Next.js (Pages Router)
• Express

Setup

First, you need to get an API key, which is available in the Resend Dashboard.

import { Resend } from 'resend';
const resend = new Resend('re_xxxx...xxxxxx');

Usage

Send your first email:

const { data } = await resend.emails.send({
  from: 'you@example.com',
  to: 'user@gmail.com',
  replyTo: 'you@example.com',
  subject: 'hello world',
  text: 'it works!',
});

console.log(`Email ${data.id} has been sent`);

[!NOTE]

In order to send from your own domain, you will first need to verify your domain in the Resend Dashboard.

Send email using HTML

Send an email custom HTML content:

const { data } = await resend.emails.send({
  from: 'you@example.com',
  to: 'user@gmail.com',
  replyTo: 'you@example.com',
  subject: 'hello world',
  html: '<strong>it works!</strong>',
});

console.log(`Email ${data.id} with custom HTML content has been sent.`);

Send email using React

Start by creating your email template as a React component.

import React from 'react';

export default function EmailTemplate({ firstName, product }) {
  return (
    <div>
      <h1>Welcome, {firstName}!</h1>
      <p>Thanks for trying {product}. We’re thrilled to have you on board.</p>
    </div>
  );
}

Then import the template component and pass it to the react property.

import EmailTemplate from '../components/EmailTemplate';

const { data } = await resend.emails.send({
  from: 'you@example.com',
  to: 'user@gmail.com',
  replyTo: 'you@example.com',
  subject: 'hello world',
  react: <EmailTemplate firstName="John" product="MyApp" />,
});

console.log(`Email ${data.id} with a React template has been sent`);

[!NOTE]

If you're sending emails from a file that doesn't have JSX transpilation set up (e.g., in a .js/.ts file instead of JSX/TSX), use React's jsx runtime function instead of passing the component as JSX:

```js

import { jsx } from 'react/jsx-runtime'

import EmailTemplate from '../components/EmailTemplate';

await resend.emails.send({

from: 'you@example.com',

to: 'user@gmail.com',

replyTo: 'you@example.com',

subject: 'hello world',

react: jsx(EmailTemplate, { firstName:"John", product:"MyApp" }),

});

```

License

MIT License