Cloudflare Workers

Prerequisites

To get the most out of this guide, you’ll need to:

Create an API key
Verify your domain
Have a Cloudflare worker with a bundling setup
- Recommended to be bootstrapped with npm create cloudflare

1. Install

Get the Resend Node.js SDK.

npm install resend

2. Create an email template

Start by creating your email template on src/emails/email-template.tsx:

src/emails/email-template.tsx

import * as React from 'react';

interface EmailTemplateProps {
  firstName: string;
}

export const EmailTemplate: React.FC<Readonly<EmailTemplateProps>> = ({
  firstName,
}) => (
  <div>
    <h1>Welcome, {firstName}!</h1>
  </div>
);

export default EmailTemplate;

3. Send the email using React and the SDK

Change the file extension of the worker’s main file to tsx and modify your configurations.

After that, you can send your email using the react parameter:

src/index.tsx

import { Resend } from 'resend';
import { EmailTemplate } from './emails/email-template';

export default {
  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
    const resend = new Resend('re_123456789');

    const data = await resend.emails.send({
      from: 'Acme <onboarding@resend.dev>',
      to: ['delivered@resend.dev'],
      subject: 'hello world',
      react: <EmailTemplate firstName="John" />,
    }):

    return new Response(JSON.stringify(data), {
      headers: {
        'Content-Type': 'application/json',
      },
    });
  },
};

4. Deploy and send email

Run wrangler deploy and wait for it to finish. Once it’s done, it will give you a URL to try out, like https://my-worker.your_name.workers.dev, that you can open and verify that your email has been sent.

5. Try it yourself