Send Email

Send an email using the Resend Go SDK

Send

Sends an email with the given parameters.

func (s *EmailsSvcImpl) Send(params *SendEmailRequest) (*SendEmailResponse, error)

Parameters

params · *SendEmailRequest · required

The email parameters

Show SendEmailRequest fields

From · string · required

Sender email address. Must be from a verified domain.

To · []string · required

Recipient email addresses.

Subject · string · required

Email subject line.

Html · string

HTML version of the message.

Text · string

Plain text version of the message.

Bcc · []string

Blind carbon copy recipients.

Cc · []string

Carbon copy recipients.

ReplyTo · string

Reply-to email address.

Tags · []Tag

Custom metadata tags for the email.

Show Tag fields

Name · string · required

Tag name.

Value · string · required

Tag value.

Attachments · []*Attachment

File attachments for the email.

Show Attachment fields

Content · []byte

Binary content of the attachment. Use when Path is not available.

Filename · string · required

Filename that will appear in the email. Pick the correct extension for proper preview.

Path · string

URL path where the attachment file is hosted instead of providing content directly.

ContentType · string

Content type for the attachment. If not set, derived from the filename.

ContentId · string

Optional content ID for inline attachments. Reference in HTML using cid: prefix.

Headers · map[string]string

Custom email headers.

ScheduledAt · string

Schedule email for future delivery. Format: ISO 8601 (e.g., “2024-09-05T11:52:01.858Z”).

Template · *EmailTemplate

Template configuration for the email.

Show EmailTemplate fields

Id · string · required

Template ID or alias to use for this email.

Variables · map[string]any

Key-value pairs to populate template placeholders.

Returns

response · *SendEmailResponse

Show SendEmailResponse fields

Id · string

The unique identifier of the sent email.

Example

package main

import (
	"fmt"
	"github.com/resend/resend-go/v3"
)

func main() {
	client := resend.NewClient("re_123456789")

	params := &resend.SendEmailRequest{
		From:    "[e-mail]",
		To:      []string{"[e-mail]"},
		Subject: "Hello from Golang",
		Text:    "hello world",
		Cc:      []string{"[e-mail]"},
		Bcc:     []string{"[e-mail]"},
		ReplyTo: "[e-mail]",
	}

	sent, err := client.Emails.Send(params)
	if err != nil {
		panic(err)
	}
	fmt.Printf("Email sent: %s\n", sent.Id)
}

---

SendWithContext

Sends an email with the given parameters and context.

func (s *EmailsSvcImpl) SendWithContext(ctx context.Context, params *SendEmailRequest) (*SendEmailResponse, error)

Parameters

ctx · context.Context · required

Context for the request.

params · *SendEmailRequest · required

The email parameters. See Send for field details.

Returns

response · *SendEmailResponse

See Send for response details.

Example

package main

import (
	"context"
	"fmt"
	"github.com/resend/resend-go/v3"
)

func main() {
	ctx := context.Background()
	client := resend.NewClient("re_123456789")

	params := &resend.SendEmailRequest{
		From:    "[e-mail]",
		To:      []string{"[e-mail]"},
		Subject: "Hello from Golang",
		Text:    "hello world",
	}

	sent, err := client.Emails.SendWithContext(ctx, params)
	if err != nil {
		panic(err)
	}
	fmt.Printf("Email sent: %s\n", sent.Id)
}

---

SendWithOptions

Sends an email with the given parameters, context, and additional options.

func (s *EmailsSvcImpl) SendWithOptions(ctx context.Context, params *SendEmailRequest, options *SendEmailOptions) (*SendEmailResponse, error)

Parameters

ctx · context.Context · required

Context for the request.

params · *SendEmailRequest · required

The email parameters. See Send for field details.

options · *SendEmailOptions · required

Additional options for sending the email.

Show SendEmailOptions fields

IdempotencyKey · string

Unique key to ensure idempotent email sending. Prevents duplicate sends.

Returns

response · *SendEmailResponse

See Send for response details.

Example

package main

import (
	"context"
	"fmt"
	"github.com/resend/resend-go/v3"
)

func main() {
	ctx := context.Background()
	client := resend.NewClient("re_123456789")

	params := &resend.SendEmailRequest{
		From:    "[e-mail]",
		To:      []string{"[e-mail]"},
		Subject: "Hello from Golang",
		Text:    "hello world",
	}

	options := &resend.SendEmailOptions{
		IdempotencyKey: "unique-idempotency-key",
	}

	sent, err := client.Emails.SendWithOptions(ctx, params, options)
	if err != nil {
		panic(err)
	}
	fmt.Printf("Email sent: %s\n", sent.Id)
}