Encore is an open-source Go 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.

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

encore app create --lang=go my-app

Then install the Resend Go SDK:

go get github.com/resend/resend-go/v3

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

Send email using an API endpoint

Create an email service directory and define your endpoint:

email/email.go

package email

import (
    "context"

    "github.com/resend/resend-go/v3"
)

var secrets struct {
    ResendAPIKey string
}

type SendRequest struct {
    To      string `json:"to"`
    Subject string `json:"subject"`
    HTML    string `json:"html"`
}

type SendResponse struct {
    ID string `json:"id"`
}

//encore:api public method=POST path=/email/send
func Send(ctx context.Context, req *SendRequest) (*SendResponse, error) {
    client := resend.NewClient(secrets.ResendAPIKey)

    sent, err := client.Emails.Send(&resend.SendEmailRequest{
        From:    "Acme <onboarding@resend.dev>",
        To:      []string{req.To},
        Subject: req.Subject,
        Html:    req.HTML,
    })
    if err != nil {
        return nil, err
    }

    return &SendResponse{ID: sent.Id}, nil
}

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 Go

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

Encore Go Docs

Resend Go SDK

​Prerequisites

​Guide

​Examples

Encore Go Docs

Resend Go SDK

Prerequisites

Guide

Examples