Skip to main content
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.

Open in Cursor

​
Prerequisites

Before you start, you’ll need:

​
Guide

1

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
2

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
3

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
}
4

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>"}'
5

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

​
Examples

Encore Go Docs

Encore Go documentation

Resend Go SDK

Resend Go SDK on GitHub