1. Integrations
  2. Send email using AWS SES

1. Install dependencies

Get the @react-email/render package and the AWS SES Node.js SDK.

npm install @react-email/render aws-sdk

2. Create an email using React

Start by building your email template in a .jsx or .tsx file.

email.jsx
import * as React from 'react';
import { Html } from '@react-email/html';
import { Button } from '@react-email/button';

export function Email(props) {
  const { url } = props;

  return (
    <Html lang="en">
      <Button href={url}>Click me</Button>
    </Html>
  );
}

3. Convert to HTML and send email

Import the email template you just built, convert into a HTML string, and use the AWS SES SDK to send it.

import { render } from '@react-email/render';
import AWS from 'aws-sdk';
import { Email } from './email';

AWS.config.update({ region: process.env.AWS_SES_REGION });

const emailHtml = render(<Email url="https://example.com" />);

const options = {
  Source: 'you@example.com',
  Destination: {
    ToAddresses: ['user@gmail.com'],
  },
  Message: {
    Body: {
      Html: {
        Charset: 'UTF-8',
        Data: emailHtml,
      },
    },
    Subject: {
      Charset: 'UTF-8',
      Data: 'hello world',
    },
  },
};

const sendPromise = new AWS.SES({ apiVersion: '2010-12-01' })
  .sendEmail(options)
  .promise();

Try it yourself

AWS SES example

See the full source code.