Overview

Amazon SES (Simple Email Service) is AWS's transactional + bulk email service. The Automize AWS SES connector covers sending email (one-off and templated bulk), managing verified identities (domains + addresses), templates, contact lists, configuration sets, and the suppression list.

Regions: SES is regional. Pick the region with your verified domains. Cross-region sending requires verifying identities in each region.
Plans: Pay-as-you-go. Free tier 62,000 outbound emails / month from an EC2 or Lambda. New accounts start in sandbox (verified senders only) – request production access in AWS Console.

Setting up the connection

Auth type: aws_sigv4.

AWS Console → SES → Verified Identities → Create identity (domain or email address).
Domain verification: add the DKIM + SPF records SES gives you to your DNS.
IAM → user with programmatic access → attach AmazonSESFullAccess (or scoped subset).
Request production access (otherwise you can only send to verified addresses).
In Automize, open Settings → Connectors → AWS SES → Add connection. Paste keys + region.

Find your credentials at https://us-east-1.console.aws.amazon.com/iam/home.

Rate limits

Daily quota + max send rate (per second) per region – both scale with your reputation. New accounts start at 200/day, 1/sec. Get Account returns current limits. The connector retries on Throttling errors with exponential backoff.

Data model

SES primitives:

    Account ─┬─ Verified Identities (domains + addresses, must verify before sending)
             ├─ Configuration Sets (event publishing + sending policies)
             ├─ Email Templates (re-usable HTML/text with placeholders)
             ├─ Contact Lists ── Contacts (opt-in subscribers for bulk)
             └─ Suppression List (bounces + complaints, auto-managed)

Available operations

24 operations available. Click any row to jump to its detail.

Operation	Category	What it does
Create Configuration Set	General	Create a new configuration set
Create Contact	General	Add a contact to a contact list
Create Contact List	General	Create a new contact list
Create Email Identity	General	Verify a new email identity (domain or address)
Create Email Template	General	Create a new email template
Delete Contact	General	Remove a contact from a contact list
Delete Email Identity	General	Delete a verified email identity
Delete Email Template	General	Delete an email template
Delete Suppressed Destination	General	Remove an address from the suppression list
Get Account	General	Get SES account details and sending limits
Get Configuration Set	General	Get configuration set details
Get Deliverability Dashboard	General	Get deliverability dashboard overview
Get Email Identity	General	Get details of a verified identity
Get Email Template	General	Get an email template
Get Suppressed Destination	General	Get suppression details for an address
List Configuration Sets	General	List email configuration sets
List Contact Lists	General	List all contact lists
List Contacts	General	List contacts in a contact list
List Email Identities	General	List verified email identities (domains and addresses)
List Email Templates	General	List email templates
List Suppressed Destinations	General	List suppressed email addresses
Put Suppressed Destination	General	Add an address to the suppression list
Send Bulk Email	General	Send email to multiple destinations using a template
Send Email	General	Send an email message

Operations

Create Configuration Set

Create a new configuration set

No input parameters.

Tips

Define event destinations (where bounce/click events get published) after creation via the AWS Console – connector creates only the set.

Create Contact

Add a contact to a contact list

Parameter	Required	Type	Description
Contact List Name `contact_list_name`	Yes	text

Tips

email + topic_preferences (per-topic OPT_IN / OPT_OUT). Honour user preferences.

Create Contact List

Create a new contact list

No input parameters.

Tips

Name + topics (subscription buckets within the list).

Create Email Identity

Verify a new email identity (domain or address)

No input parameters.

Tips

Domain or email. For domains, response includes DKIM records to add to DNS.

Create Email Template

Create a new email template

No input parameters.

Tips

subject + html + text + name. Use {{placeholders}} for runtime substitution.

Delete Contact

Remove a contact from a contact list

Parameter	Required	Type	Description
Contact List Name `contact_list_name`	Yes	text
Email Address `email_address`	Yes	text

Tips

Removes from a contact list. Doesn't affect suppression list.

Delete Email Identity

Delete a verified email identity

Parameter	Required	Type	Description
Email Identity `email_identity`	Yes	text

Tips

Unverifies. Stops sending from that identity.

Delete Email Template

Delete an email template

Parameter	Required	Type	Description
Template Name `template_name`	Yes	text

Tips

Hard-delete.

Delete Suppressed Destination

Remove an address from the suppression list

Parameter	Required	Type	Description
Email Address `email_address`	Yes	text

Tips

Removes an address from suppression – re-enables sending. Use after the user has explicitly resubscribed.

Get Account

Get SES account details and sending limits

No input parameters.

Tips

Returns current sending quota + production-access status. Useful for monitoring.

Get Configuration Set

Get configuration set details

Parameter	Required	Type	Description
Configuration Set Name `configuration_set_name`	Yes	text

Tips

Returns config + event destinations + sending policies.

Get Deliverability Dashboard

Get deliverability dashboard overview

No input parameters.

Tips

Reputation tracking + ISP placement insights. Requires paid Deliverability Dashboard subscription.

Get Email Identity

Get details of a verified identity

Parameter	Required	Type	Description
Email Identity `email_identity`	Yes	text

Tips

Returns verification status + DKIM config. Check before sending.

Get Email Template

Get an email template

Parameter	Required	Type	Description
Template Name `template_name`	Yes	text

Tips

Returns full template incl. subject + body.

Get Suppressed Destination

Get suppression details for an address

Parameter	Required	Type	Description
Email Address `email_address`	Yes	text

Tips

Returns reason + date for a suppressed address.

List Configuration Sets

List email configuration sets

No input parameters.

Tips

Configuration sets enable event publishing (to SNS, CloudWatch, S3) for bounces, complaints, opens, clicks, deliveries.

List Contact Lists

List all contact lists

No input parameters.

Tips

Contact lists for marketing flows. Used by Send Bulk Email.

List Contacts

List contacts in a contact list

Parameter	Required	Type	Description
Contact List Name `contact_list_name`	Yes	text

Tips

Contacts in a list. Each contact has an opt-in status per topic.

List Email Identities

List verified email identities (domains and addresses)

No input parameters.

Tips

Returns verified domains + email addresses + their statuses.

List Email Templates

List email templates

No input parameters.

Tips

Templates are referenced by name in Send Bulk Email.

List Suppressed Destinations

List suppressed email addresses

No input parameters.

Tips

Auto-suppressed addresses (bounces, complaints). SES respects this list – sending to a suppressed address is silently dropped.

Put Suppressed Destination

Add an address to the suppression list

No input parameters.

Tips

Manually add an address. reasons: BOUNCE or COMPLAINT.

Send Bulk Email

Send email to multiple destinations using a template

No input parameters.

Tips

Up to 50 destinations per call. Uses a template_name.
Each destination has its own replacement_template_data – different recipients see different values.

Send Email

Send an email message

No input parameters.

Tips

destination + content (subject + body) + from_email_address (must be a verified identity).
configuration_set_name to track opens/clicks/bounces via SES events.
Sandbox accounts can only send to verified destinations.

Errors

MessageRejected – Body fails policy or destination on suppression list.
MailFromDomainNotVerified – from_email_address isn't a verified identity in this region.

FAQ

How do I escape SES sandbox?: AWS Console → SES → Request production access. Fill out the use case + expected volume + bounce handling. AWS typically approves in 24h. Until then you can only send to verified addresses.
v2 vs v1 SES API?: This connector uses SES v2. v1 (the legacy 'sendmail' API) is being deprecated. All new builds should use v2.
DKIM – how?: When you create a domain identity, SES returns 3 CNAME records. Add them to your domain's DNS. SES re-checks within hours. DKIM signing is automatic after verification.
Why is my SES email going to spam?: Verify the domain (DKIM + SPF), use a custom MAIL FROM domain, warm up sending volume gradually, monitor the deliverability dashboard.

AWS SES integration

Overview

Setting up the connection

Rate limits

Data model

Available operations

Operations

Create Configuration Set

Create Contact

Create Contact List

Create Email Identity

Create Email Template

Delete Contact

Delete Email Identity

Delete Email Template

Delete Suppressed Destination

Get Account

Get Configuration Set

Get Deliverability Dashboard

Get Email Identity

Get Email Template

Get Suppressed Destination

List Configuration Sets

List Contact Lists

List Contacts

List Email Identities

List Email Templates

List Suppressed Destinations

Put Suppressed Destination

Send Bulk Email

Send Email

FAQ

Related connectors

See it working on your own data