Send emails with Encore

Encore is an open-source TypeScript framework that provisions infrastructure directly from your application code, with built-in observability and cloud deployment.

Use this pre-built prompt to get started faster.

Open in Cursor

Prerequisites

Before you start, you’ll need:

A Resend API key
A verified domain
Install Encore (brew install encoredev/tap/encore)

Guide

Create an Encore app

The quickest way to get started is with the Resend starter template:

encore app create --example=ts/resend

Or install the SDK into an existing Encore project:

npm install resend

yarn add resend

pnpm add resend

bun add resend

Set your API key

Encore has built-in secrets management. Store your Resend API key as a secret - no .env files needed:

encore secret set --type dev,local,pr,production ResendAPIKey

Initialize the client using the secret:

email/resend.ts

import { Resend } from 'resend';
import { secret } from 'encore.dev/config';

const resendApiKey = secret('ResendAPIKey');

export const resend = new Resend(resendApiKey());

Define a service

Every Encore.ts service needs a service definition file:

email/encore.service.ts

import { Service } from 'encore.dev/service';

export default new Service('email');

Send email using an API endpoint

Create a type-safe API endpoint to send emails:

email/send.ts

import { api } from 'encore.dev/api';
import { resend } from './resend';

interface SendRequest {
  to: string;
  subject: string;
  html: string;
}

interface SendResponse {
  id: string;
}

export const sendEmail = api(
  { expose: true, method: 'POST', path: '/email/send' },
  async (req: SendRequest): Promise<SendResponse> => {
    const { data, error } = await resend.emails.send({
      from: 'Acme <onboarding@resend.dev>',
      to: req.to,
      subject: req.subject,
      html: req.html,
    });

    if (error) {
      throw new Error(`Failed to send email: ${error.message}`);
    }

    return { id: data!.id };
  },
);

Async delivery with Pub/Sub (optional)

For production, use Encore’s built-in Pub/Sub to send emails asynchronously with automatic retries:

email/topic.ts

import { Topic, Subscription } from 'encore.dev/pubsub';
import { resend } from './resend';

interface EmailEvent {
  to: string;
  subject: string;
  html: string;
}

export const emailTopic = new Topic<EmailEvent>('emails', {
  deliveryGuarantee: 'at-least-once',
});

const _ = new Subscription(emailTopic, 'send-email', {
  handler: async (event) => {
    const { data, error } = await resend.emails.send({
      from: 'Acme <onboarding@resend.dev>',
      to: event.to,
      subject: event.subject,
      html: event.html,
    });

    if (error) {
      throw new Error(error.message);
    }

    console.log('Email sent:', data?.id);
  },
});

Then publish from any endpoint:

import { emailTopic } from './topic';

await emailTopic.publish({
  to: 'delivered@resend.dev',
  subject: 'Welcome!',
  html: '<p>Thanks for signing up.</p>',
});

Run the app

encore run

Your API is running at http://localhost:4000. Send a test email:

curl -X POST http://localhost:4000/email/send \
  -H "Content-Type: application/json" \
  -d '{"to":"delivered@resend.dev","subject":"Hello World","html":"<strong>It works!</strong>"}'

AI skills for Encore.ts

If you’re using an AI coding assistant, install the Encore skills. They provide context-aware help with topics such as APIs, services, Pub/Sub, databases, and auth:

npx skills add encoredev/skills

Send emails with Encore

Prerequisites

Guide

Examples

Resend Starter

Encore.ts Docs

​Prerequisites

​Guide

​Examples

Resend Starter

Encore.ts Docs

Prerequisites

Guide

Examples