Amazon SES
Configure Amazon Simple Email Service for sending emails
Amazon SES (Simple Email Service) is a cost-effective email service built on AWS infrastructure. It's ideal for high-volume email sending. Lunogram delivers email through the SES v2 API using AWS Signature V4 authentication.
Features
- Email sending via the Amazon SES v2 API
- IAM credential support, including optional STS session tokens
- Configuration set support for dedicated IP pools and event publishing
- Works in any SES region
Delivery and bounce notifications from SES are published through Amazon SNS rather than a direct webhook. Lunogram does not yet ingest SNS notifications, so engagement and bounce tracking are not available for SES today. Sending is fully supported.
Setup
1. Enable SES and Verify Your Domain
- Open the SES console
- Verify your sending domain (or a specific email address) under Verified identities
- Add the DKIM and SPF DNS records SES provides
2. Request Production Access
New SES accounts start in the sandbox, which only allows sending to verified addresses. Request production access to send to any recipient.
3. Create IAM Credentials
- In IAM, create a user (or role) with permission to call
ses:SendEmail - Generate an Access Key ID and Secret Access Key
- If you authenticate with temporary credentials, also capture the Session Token
4. Configure in Lunogram
- Open your Lunogram project settings
- Navigate to Integrations and click Add Integration
- Select Amazon SES from the list of providers
- Enter your configuration:
- Access Key ID: Your IAM access key ID
- Secret Access Key: Your IAM secret access key
- AWS Region: The SES region, e.g.
us-east-1 - Session Token (optional): Required only when using temporary STS credentials
- Configuration Set (optional): An SES configuration set name
- Click Save to create the provider
Configuration Options
| Field | Required | Description |
|---|---|---|
| Access Key ID | Yes | IAM access key ID with ses:SendEmail permission |
| Secret Access Key | Yes | IAM secret access key |
| AWS Region | Yes | The SES region (for example us-east-1) |
| Session Token | No | Optional STS session token for temporary credentials |
| Configuration Set | No | Optional SES configuration set name |
Pricing
Amazon SES is one of the most cost-effective email providers:
- $0.10 per 1,000 emails sent
- Free tier: 62,000 emails/month when sent from EC2
Troubleshooting
Emails Not Sending
- Confirm the IAM credentials have
ses:SendEmailpermission - Check that the AWS Region matches the region where your identity is verified
- While in the sandbox, you can only send to verified recipients — request production access to send to anyone
- Ensure the "from" address uses a verified domain or identity