Reference
Amazon SES template API and CLI reference.
Last updated 11 November 2026
Every SES API v2 operation for email templates on one page, with its AWS CLI command, rate limit, and errors. Each entry links to the AWS reference it was taken from.
Skip the commands
List, edit, preview, and publish your SES templates in the browser, across AWS accounts.
Open the editorOperations at a glance
| API operation | AWS CLI command | What it does | Rate limit |
|---|---|---|---|
CreateEmailTemplate | create-email-template | Creates a template | Once per second |
GetEmailTemplate | get-email-template | Returns one template’s content | 50 per second |
ListEmailTemplates | list-email-templates | Lists templates in the current Region | Once per second |
UpdateEmailTemplate | update-email-template | Replaces a template’s content | Once per second |
DeleteEmailTemplate | delete-email-template | Deletes a template | Once per second |
TestRenderEmailTemplate | test-render-email-template | Previews the rendered MIME message | Once per second |
All commands are under aws sesv2. The walkthroughs in the SES developer guide are Using templates to send personalized email and Managing email templates.
Template content
Create, get, and update all use the EmailTemplateContent object:
{
"Subject": "string",
"Html": "string",
"Text": "string"
}| Field | Description |
|---|---|
Subject | The subject line of the email |
Html | The HTML body of the email |
Text | The body shown to recipients whose email clients don’t display HTML |
CloudFormation’s AWS::SES::Template uses different names for the same parts: SubjectPart, HtmlPart, and TextPart (property reference).
Create
aws sesv2 create-email-template --cli-input-json file://template.json{
"TemplateName": "welcome",
"TemplateContent": {
"Subject": "Welcome, {{firstName}}",
"Text": "Hi {{firstName}}",
"Html": "<h1>Hi {{firstName}}</h1>"
}
}Takes TemplateName and TemplateContent, both required, and optional Tags. Returns an empty body. Errors: AlreadyExistsException, BadRequestException, LimitExceededException, TooManyRequestsException. Step by step: how to create an SES template.
Get
aws sesv2 get-email-template --template-name welcomeReturns TemplateName, TemplateContent, and Tags. It returns the template as it is now. Errors: BadRequestException, NotFoundException, TooManyRequestsException.
List
aws sesv2 list-email-templates --page-size 100Lists the templates in your SES account in the current Region. Returns a TemplatesMetadata array with each template’s name and creation timestamp. PageSize can be from 1 to 100. When there are more results, the response includes a NextToken to pass to the next call. Errors: BadRequestException, TooManyRequestsException.
Update
aws sesv2 update-email-template \
--template-name welcome \
--template-content file://content.jsonTakes the template name and a full TemplateContent. AWS’s guide says any lines you omit are removed from the template, so include all three parts. Returns an empty body. Errors: BadRequestException, NotFoundException, TooManyRequestsException. Step by step: how to edit SES templates.
Delete
aws sesv2 delete-email-template --template-name welcomeDeletes the template and returns an empty body. Errors: BadRequestException, NotFoundException, TooManyRequestsException.
Test render
aws sesv2 test-render-email-template \
--template-name welcome \
--template-data '{"firstName":"Ada"}'Takes the template name and TemplateData, a JSON string of up to 262,144 characters. Returns RenderedTemplate, the complete MIME message. Errors: BadRequestException, NotFoundException, TooManyRequestsException. More in how to test SES templates.
Send with a template
aws sesv2 send-email --cli-input-json file://email.json
aws sesv2 send-bulk-email --cli-input-json file://bulk-email.jsonSendEmail sends one templated email to a single destination object. SendBulkEmail sends a unique email to each of up to 50 destination objects per call. Both take the template name and TemplateData as an escaped JSON string, and both accept an inline template in place of a stored one. If rendering fails, SES reports a Rendering Failure event. See SES template rendering failures.
Limits
| Limit | Value |
|---|---|
| Stored templates per AWS Region | 20,000 |
| Stored template size (text and HTML) | 500 KB |
| Inline template input size | 1 MB |
| Replacement variables | No limit |
Destinations per SendBulkEmail call | 50 |
TemplateData for a test render | 262,144 characters |
Source: Using templates to send personalized email and the SES API v2 reference. For how templates work as a whole, read the SES templates guide. To manage templates without the CLI, see the SES template manager.
FAQ
Which API operations manage Amazon SES email templates?
In the SES API v2: CreateEmailTemplate, GetEmailTemplate, ListEmailTemplates, UpdateEmailTemplate, DeleteEmailTemplate, and TestRenderEmailTemplate. You send with a template using SendEmail or SendBulkEmail.
What are the rate limits for SES template operations?
The SES API v2 reference says you can run GetEmailTemplate no more than 50 times per second, and CreateEmailTemplate, UpdateEmailTemplate, DeleteEmailTemplate, ListEmailTemplates, and TestRenderEmailTemplate no more than once per second each.
What is the AWS CLI command to list SES templates?
aws sesv2 list-email-templates. It returns a TemplatesMetadata array with each template’s name and creation timestamp for the current Region. PageSize can be from 1 to 100, and a NextToken is returned when there are more results.
Does UpdateEmailTemplate merge my changes into the template?
No. AWS’s guide to managing templates says any lines you omit are removed from the template, so send the subject, text, and HTML parts together even when you change only one.