# AWS SES (/integrations/ses)





{/* MANUAL-CONTENT-START:intro */}

Use [Amazon SES](https://aws.amazon.com/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.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

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 [#actions]

### SES Send Email [#ses-send-email]

Send an email via AWS SES using simple or HTML content

<ReferenceDetails>
  #### Input [#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 [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `messageId` | string | SES message ID for the sent email |
</ReferenceDetails>

### SES Send Templated Email [#ses-send-templated-email]

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

<ReferenceDetails>
  #### Input [#input-1]

  | 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 [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `messageId` | string | SES message ID for the sent email |
</ReferenceDetails>

### SES Send Bulk Email [#ses-send-bulk-email]

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

<ReferenceDetails>
  #### Input [#input-2]

  | 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 [#output-2]

  | 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 |
</ReferenceDetails>

### SES List Identities [#ses-list-identities]

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

<ReferenceDetails>
  #### Input [#input-3]

  | 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 [#output-3]

  | 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 |
</ReferenceDetails>

### SES Get Account [#ses-get-account]

Get SES account sending quota and status information

<ReferenceDetails>
  #### Input [#input-4]

  | 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 [#output-4]

  | 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 |
</ReferenceDetails>

### SES Create Template [#ses-create-template]

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

<ReferenceDetails>
  #### Input [#input-5]

  | 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 [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Confirmation message for the created template |
</ReferenceDetails>

### SES Get Template [#ses-get-template]

Retrieve the content and details of an SES email template

<ReferenceDetails>
  #### Input [#input-6]

  | 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 [#output-6]

  | 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 |
</ReferenceDetails>

### SES List Templates [#ses-list-templates]

List all SES email templates in your account

<ReferenceDetails>
  #### Input [#input-7]

  | 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 [#output-7]

  | 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 |
</ReferenceDetails>

### SES Delete Template [#ses-delete-template]

Delete an existing SES email template

<ReferenceDetails>
  #### Input [#input-8]

  | 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 [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Confirmation message for the deleted template |
</ReferenceDetails>

### SES Update Template [#ses-update-template]

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

<ReferenceDetails>
  #### Input [#input-9]

  | 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 [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Confirmation message |
</ReferenceDetails>

### SES Put Suppressed Destination [#ses-put-suppressed-destination]

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

<ReferenceDetails>
  #### Input [#input-10]

  | 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 [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Confirmation message |
</ReferenceDetails>

### SES Delete Suppressed Destination [#ses-delete-suppressed-destination]

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

<ReferenceDetails>
  #### Input [#input-11]

  | 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 [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Confirmation message |
</ReferenceDetails>

### SES Get Suppressed Destination [#ses-get-suppressed-destination]

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

<ReferenceDetails>
  #### Input [#input-12]

  | 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 [#output-12]

  | 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 |
</ReferenceDetails>

### SES List Suppressed Destinations [#ses-list-suppressed-destinations]

List email addresses on the account-level SES suppression list

<ReferenceDetails>
  #### Input [#input-13]

  | 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 [#output-13]

  | 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 |
</ReferenceDetails>

### SES Create Email Identity [#ses-create-email-identity]

Start verification of a new SES email address or domain identity

<ReferenceDetails>
  #### Input [#input-14]

  | 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 [#output-14]

  | 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 |
</ReferenceDetails>

### SES Delete Email Identity [#ses-delete-email-identity]

Delete a verified SES email address or domain identity

<ReferenceDetails>
  #### Input [#input-15]

  | 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 [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Confirmation message |
</ReferenceDetails>

### SES Get Email Identity [#ses-get-email-identity]

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

<ReferenceDetails>
  #### Input [#input-16]

  | 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 [#output-16]

  | 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) |
</ReferenceDetails>

### SES Create Configuration Set [#ses-create-configuration-set]

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

<ReferenceDetails>
  #### Input [#input-17]

  | 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 [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `message` | string | Confirmation message |
</ReferenceDetails>

### SES Send Custom Verification Email [#ses-send-custom-verification-email]

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

<ReferenceDetails>
  #### Input [#input-18]

  | 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 [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `messageId` | string | SES message ID for the sent verification email |
</ReferenceDetails>