Skip to main content

Install

Quick start (AWS SES)

Currently, AWS_SES is supported. MAILGUN and SENDGRID return an error: “not supported yet”.

Required environment variables

Set these in your environment (or .env) before running:
Ensure your IAM user/role has SES permissions (e.g. ses:SendEmail, ses:SendRawEmail) in the region you use.

Verify identities in SES

  1. Verify the sender address or verify your domain in SES.
  2. If your account is in the SES sandbox, you must also verify recipient emails (or request production access).
  3. Confirm you’re using the same region for credentials and SES.
Helpful checks:
  • From address (e.g., no-reply@yourdomain.com) must be verified.
  • Region in env must match the SES region you configured.

Create a client

Build an email

SendSingleMail expects a models.SingleEmailRequest. Use the exact fields from your models package. Common fields typically include To, Subject, HTML and/or Text.

Send and handle errors