Send (& receive) emails using Inbound

1. Install dependencies

Get the react-email package and the Inbound Node.js SDK. Make sure you have an account on inbound, you will need an inbound API key.

npm install inboundemail react-email

yarn add inboundemail react-email

pnpm add inboundemail react-email

bun add inboundemail react-email

2. Create an email using React

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

email.tsx

import * as React from 'react';
import { Html, Button } from "react-email";

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

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

export default Email;

3. Send email

When integrating with other services, you need to convert your React template into HTML before sending. Inbound takes care of that for you. You can just directly pass the React template to the SDK.

Import the email template you just built and use the Inbound SDK to send it.

import { Inbound } from 'inboundemail';
import { Email } from './email';

const inbound = new Inbound(process.env.INBOUND_API_KEY);

await inbound.emails.send({
  from: 'you@example.com',
  to: 'user@gmail.com',
  subject: 'hello world',
  react: <Email url="https://example.com" />,
});

4. Reply to an email

Use the Inbound SDK to reply to an email with the same template you just created.

import { Inbound } from 'inboundemail';
import { Email } from './email';

const inbound = new Inbound({
    apiKey: process.env.INBOUND_API_KEY
});

// sending an email via inbound
await inbound.emails.send(email.id,{
  from: "React Email <react.email@inbound.new>",
  react: <Email url="https://example.com" />
});

// replying to an email that was received via inbound
await inbound.emails.reply(email.id,{
  from: "React Email <react.email@inbound.new>",
  react: <Email url="https://example.com" />
});

Try it yourself

Get started on Inbound

See it on our examples.

​1. Install dependencies

​2. Create an email using React

​3. Send email

​4. Reply to an email

​Try it yourself

Get started on Inbound

1. Install dependencies

2. Create an email using React

3. Send email

4. Reply to an email

Try it yourself