Connectors
Amazon SES
Connect Amazon SES when your team standardizes delivery infrastructure on AWS.
Use the Amazon SES connector when AWS is your preferred delivery platform or when procurement, compliance, or infrastructure ownership already points to SES.
Before you start
- Verify the sending identity in SES.
- Move the SES account out of sandbox mode for production traffic.
- Create IAM credentials with least-privilege send permissions.
- Decide which AWS region owns the sending identity.
Setup
sequenceDiagram
participant Admin as Workspace admin
participant AWS as Amazon SES
participant MG as GenieOS
participant Recipient as Recipient
Admin->>AWS: Verify identity and create IAM credentials
Admin->>MG: Install SES connector
MG->>AWS: Send test via SES API
AWS->>Recipient: Deliver email
AWS->>MG: SNS or event destination callbacks- Open Settings -> Connectors and choose Amazon SES.
- Enter the AWS region and IAM credentials.
- Configure the verified sender identity.
- Configure provider events through the webhook mechanism shown in the connector setup flow.
- Send a connector test.
Capabilities
| Capability | Support |
|---|---|
| Transactional sends | Yes |
| Broadcast sends | Yes, subject to SES quotas |
| Attachments | SES message size limits apply |
| Inline images | SES message limits apply |
| Webhooks | Through SES event destinations or SNS-backed callbacks |
| Suppressions | GenieOS suppressions checked before send; provider signals can suppress recipients |
Webhooks and suppressions
SES event publishing must be configured for the identity or configuration set used by GenieOS. At minimum, route bounces and complaints back to GenieOS so future sends are suppressed correctly.
Troubleshooting
- Sandbox errors mean the SES account or region is not approved for production sending.
- Signature or credential errors usually mean the IAM user lacks SES send permissions or was created in the wrong account.
- Missing event data usually means the configuration set or event destination is not attached to the send path.
SES quotas are regional. Increasing a quota in one region does not increase limits in another.