thormail-adapter-ses
v1.0.3
Published
Amazon SES adapter for ThorMail using AWS SDK v3 (SESv2 Client)
Downloads
95
Maintainers
Readme
Amazon SES Adapter for ThorMail
Adapter for ThorMail, the professional self-hosted email orchestration server.
[!IMPORTANT] To use this adapter, you must have a running instance of ThorMail installed. This adapter is designed to be installed and managed directly from the ThorMail Admin Panel.
Allows you to send transactional and marketing emails via Amazon Simple Email Service (SES) using the official AWS SDK v3 (SESv2 Client).
Installation
- Go to your ThorMail Admin Panel.
- Navigate to the Adapters section.
- Click Add New Adapter.
- Search for
thormail-adapter-sesand click Install.
Configuration
In your ThorMail dashboard, navigate to Connections and select Amazon SES.
Required Fields
- AWS Region: The AWS region where your SES identity is verified (e.g.,
us-east-1). - Access Key ID: Your AWS IAM User Access Key ID with SES permissions.
- Secret Access Key: Your AWS IAM User Secret Access Key.
- From Email: The sender address. Must be verified in your Amazon SES console (unless your account is out of Sandbox mode).
Optional Fields
- From Name: The friendly name displayed to recipients.
- Adapter Name: Internal name for this adapter instance.
- Custom Endpoint: Optional custom endpoint URL. Leave empty to use default. Useful for AWS-compatible alternatives or testing with local development (e.g., LocalStack).
Features
- AWS SDK v3 (SESv2): Built using the latest
@aws-sdk/client-sesv2for maximum performance and security. - Idempotency & Tracking: Automatically injects
ThorMail-Idempotency-Keytag to emails for tracking in AWS Console. - Smart Error Handling: Automatically detects throttling (
ThrottlingException,TooManyRequestsException) and temporarily pauses sending. - Secure: Uses official AWS signature version 4 authentication.
Getting AWS Credentials
- Log in to your AWS Console.
- Go to IAM > Users > Create user.
- Name the user (e.g.,
thormail-ses-user). - Attach policies directly: search for and select
AmazonSESFullAccess. - Create the user and copy the Access Key ID and Secret Access Key.
[!NOTE] If your AWS account is in SES Sandbox mode, you can only send emails to verified addresses. You must request a production access limit increase to send to unverified users.
License
ISC
