Skip to content

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 editor

Operations at a glance

API operationAWS CLI commandWhat it doesRate limit
CreateEmailTemplatecreate-email-templateCreates a templateOnce per second
GetEmailTemplateget-email-templateReturns one template’s content50 per second
ListEmailTemplateslist-email-templatesLists templates in the current RegionOnce per second
UpdateEmailTemplateupdate-email-templateReplaces a template’s contentOnce per second
DeleteEmailTemplatedelete-email-templateDeletes a templateOnce per second
TestRenderEmailTemplatetest-render-email-templatePreviews the rendered MIME messageOnce 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"
}
FieldDescription
SubjectThe subject line of the email
HtmlThe HTML body of the email
TextThe 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 welcome

Returns TemplateName, TemplateContent, and Tags. It returns the template as it is now. Errors: BadRequestException, NotFoundException, TooManyRequestsException.

List

aws sesv2 list-email-templates --page-size 100

Lists 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.json

Takes 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 welcome

Deletes 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.json

SendEmail 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

LimitValue
Stored templates per AWS Region20,000
Stored template size (text and HTML)500 KB
Inline template input size1 MB
Replacement variablesNo limit
Destinations per SendBulkEmail call50
TemplateData for a test render262,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.