AWS SES

Use Amazon SES to send simple, templated, or bulk emails and manage templates, identities, configuration sets, and suppression lists. Account and identity actions report sending configuration and quotas.

Use the block

Send simple, templated, and bulk emails. Manage email templates, identities, configuration sets, and the account suppression list, and retrieve account sending quota and verified identity information.

Actions

SES Send Email

Send an email via AWS SES using simple or HTML content

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`fromAddress`	string	Yes	Verified sender email address
`toAddresses`	string	Yes	Comma-separated list of recipient email addresses
`subject`	string	Yes	Email subject line
`bodyText`	string	No	Plain text email body
`bodyHtml`	string	No	HTML email body
`ccAddresses`	string	No	Comma-separated list of CC email addresses
`bccAddresses`	string	No	Comma-separated list of BCC email addresses
`replyToAddresses`	string	No	Comma-separated list of reply-to email addresses
`configurationSetName`	string	No	SES configuration set name for tracking

Output

Parameter	Type	Description
`messageId`	string	SES message ID for the sent email

SES Send Templated Email

Send an email using an SES email template with dynamic template data

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`fromAddress`	string	Yes	Verified sender email address
`toAddresses`	string	Yes	Comma-separated list of recipient email addresses
`templateName`	string	Yes	Name of the SES email template to use
`templateData`	string	Yes	JSON string of key-value pairs for template variable substitution
`ccAddresses`	string	No	Comma-separated list of CC email addresses
`bccAddresses`	string	No	Comma-separated list of BCC email addresses
`configurationSetName`	string	No	SES configuration set name for tracking

Output

Parameter	Type	Description
`messageId`	string	SES message ID for the sent email

SES Send Bulk Email

Send emails to multiple recipients using an SES template with per-recipient data

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`fromAddress`	string	Yes	Verified sender email address
`templateName`	string	Yes	Name of the SES email template to use
`destinations`	string	Yes	JSON array of destination objects with toAddresses (string[]) and optional templateData (JSON string); falls back to defaultTemplateData when omitted
`defaultTemplateData`	string	No	Default JSON template data used when a destination does not specify its own
`configurationSetName`	string	No	SES configuration set name for tracking

Output

Parameter	Type	Description
`results`	array	Per-destination send results with status and messageId
`successCount`	number	Number of successfully sent emails
`failureCount`	number	Number of failed email sends

SES List Identities

List all verified email identities (email addresses and domains) in your SES account

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`pageSize`	number	No	Maximum number of identities to return (1-1000)
`nextToken`	string	No	Pagination token from a previous list response

Output

Parameter	Type	Description
`identities`	array	List of email identities with name, type, sending status, and verification status
`nextToken`	string	Pagination token for the next page of results
`count`	number	Number of identities returned

SES Get Account

Get SES account sending quota and status information

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key

Output

Parameter	Type	Description
`sendingEnabled`	boolean	Whether email sending is enabled for the account
`max24HourSend`	number	Maximum emails allowed per 24-hour period
`maxSendRate`	number	Maximum emails allowed per second
`sentLast24Hours`	number	Number of emails sent in the last 24 hours

SES Create Template

Create a new SES email template for use with templated email sending

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`templateName`	string	Yes	Unique name for the email template
`subjectPart`	string	Yes	Subject line template (supports {{variable}} substitution)
`textPart`	string	No	Plain text version of the template body
`htmlPart`	string	No	HTML version of the template body

Output

Parameter	Type	Description
`message`	string	Confirmation message for the created template

SES Get Template

Retrieve the content and details of an SES email template

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`templateName`	string	Yes	Name of the template to retrieve

Output

Parameter	Type	Description
`templateName`	string	Name of the template
`subjectPart`	string	Subject line of the template
`textPart`	string	Plain text body of the template
`htmlPart`	string	HTML body of the template

SES List Templates

List all SES email templates in your account

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`pageSize`	number	No	Maximum number of templates to return
`nextToken`	string	No	Pagination token from a previous list response

Output

Parameter	Type	Description
`templates`	array	List of email templates with name and creation timestamp
`nextToken`	string	Pagination token for the next page of results
`count`	number	Number of templates returned

SES Delete Template

Delete an existing SES email template

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`templateName`	string	Yes	Name of the template to delete

Output

Parameter	Type	Description
`message`	string	Confirmation message for the deleted template

SES Update Template

Update the subject, HTML, and text content of an existing SES email template

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`templateName`	string	Yes	The name of the template to update
`subjectPart`	string	Yes	The subject line of the template
`htmlPart`	string	No	The HTML body of the template
`textPart`	string	No	The plain text body of the template

Output

Parameter	Type	Description
`message`	string	Confirmation message

SES Put Suppressed Destination

Add an email address to the account-level SES suppression list

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`emailAddress`	string	Yes	The email address to add to the suppression list
`reason`	string	Yes	The reason the address is suppressed: BOUNCE or COMPLAINT

Output

Parameter	Type	Description
`message`	string	Confirmation message

SES Delete Suppressed Destination

Remove an email address from the account-level SES suppression list

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`emailAddress`	string	Yes	The email address to remove from the suppression list

Output

Parameter	Type	Description
`message`	string	Confirmation message

SES Get Suppressed Destination

Retrieve details for a specific email address on the SES suppression list

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`emailAddress`	string	Yes	The suppressed email address to look up

Output

Parameter	Type	Description
`emailAddress`	string	The suppressed email address
`reason`	string	The reason the address is suppressed
`lastUpdateTime`	string	When the address was added to the suppression list
`messageId`	string	The message ID associated with the bounce or complaint event
`feedbackId`	string	The feedback ID associated with the bounce or complaint event

SES List Suppressed Destinations

List email addresses on the account-level SES suppression list

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`reasons`	string	No	Comma-separated suppression reasons to filter by: BOUNCE, COMPLAINT
`startDate`	string	No	Only include addresses suppressed after this ISO 8601 date
`endDate`	string	No	Only include addresses suppressed before this ISO 8601 date
`pageSize`	number	No	Maximum number of results to return
`nextToken`	string	No	Pagination token from a previous list response

Output

Parameter	Type	Description
`destinations`	array	List of suppressed destinations with email address, reason, and last update
`nextToken`	string	Pagination token for the next page of results
`count`	number	Number of suppressed destinations returned

SES Create Email Identity

Start verification of a new SES email address or domain identity

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`emailIdentity`	string	Yes	The email address or domain to verify
`dkimSigningAttributes`	json	No	Bring-your-own-DKIM signing attributes as JSON (domainSigningSelector, domainSigningPrivateKey, nextSigningKeyLength). Domain identities only.
`tags`	json	No	JSON array of tags to associate with the identity: [{"key":"","value":""}]
`configurationSetName`	string	No	Default configuration set to use when sending from this identity

Output

Parameter	Type	Description
`identityType`	string	The identity type: EMAIL_ADDRESS or DOMAIN
`verifiedForSendingStatus`	boolean	Whether the identity is verified and can send email
`dkimAttributes`	json	DKIM signing status and CNAME tokens for the identity

SES Delete Email Identity

Delete a verified SES email address or domain identity

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`emailIdentity`	string	Yes	The email address or domain identity to delete

Output

Parameter	Type	Description
`message`	string	Confirmation message

SES Get Email Identity

Retrieve verification status, DKIM, Mail-From, and policy details for an SES identity

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`emailIdentity`	string	Yes	The email address or domain identity to look up

Output

Parameter	Type	Description
`identityType`	string	The identity type: EMAIL_ADDRESS or DOMAIN
`verifiedForSendingStatus`	boolean	Whether the identity is verified and can send email
`verificationStatus`	string	Verification status: PENDING, SUCCESS, FAILED, TEMPORARY_FAILURE, NOT_STARTED
`feedbackForwardingStatus`	boolean	Whether bounce/complaint notifications are forwarded by email
`configurationSetName`	string	Default configuration set for this identity
`dkimAttributes`	json	DKIM signing status and CNAME tokens for the identity
`mailFromAttributes`	json	Custom MAIL FROM domain configuration for the identity
`policies`	json	Sending authorization policies attached to the identity
`tags`	array	Tags associated with the identity
`verificationInfo`	json	Additional verification diagnostics (error type, last checked/success time)

SES Create Configuration Set

Create an SES configuration set to control tracking, delivery, reputation, sending, and suppression behavior for emails

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`configurationSetName`	string	Yes	Name of the configuration set (letters, numbers, hyphens, underscores)
`customRedirectDomain`	string	No	Custom domain to use for open/click tracking links
`httpsPolicy`	string	No	HTTPS policy for tracking links: REQUIRE, REQUIRE_OPEN_ONLY, or OPTIONAL
`tlsPolicy`	string	No	Whether delivery requires TLS: REQUIRE or OPTIONAL
`sendingPoolName`	string	No	Dedicated IP pool to associate with the configuration set
`reputationMetricsEnabled`	boolean	No	Whether to collect reputation metrics for emails using this configuration set
`sendingEnabled`	boolean	No	Whether sending is enabled for this configuration set
`suppressedReasons`	string	No	Comma-separated reasons that trigger suppression: BOUNCE, COMPLAINT
`tags`	json	No	JSON array of tags to associate with the configuration set: [{"key":"","value":""}]

Output

Parameter	Type	Description
`message`	string	Confirmation message

SES Send Custom Verification Email

Send a branded custom verification email to an address using a custom verification email template

Inputs and outputs

Input

Parameter	Type	Required	Description
`region`	string	Yes	AWS region (e.g., us-east-1)
`accessKeyId`	string	Yes	AWS access key ID
`secretAccessKey`	string	Yes	AWS secret access key
`emailAddress`	string	Yes	The email address to verify
`templateName`	string	Yes	The name of the custom verification email template to use
`configurationSetName`	string	No	Configuration set to use when sending the verification email

Output

Parameter	Type	Description
`messageId`	string	SES message ID for the sent verification email