There are more AWS SDK examples available in the [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub repo.
# Use `CreateEmailTemplate` with an AWS SDK
The following code examples show how to use `CreateEmailTemplate`.
Action examples are code excerpts from larger programs and must be run in context. You can see this action in context in the following code example:
+ [Newsletter scenario](sesv2_example_sesv2_NewsletterWorkflow_section.md)
------
#### [ .NET ]
**SDK for .NET**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/SESv2#code-examples).
```
///
/// Creates an email template with the specified content.
///
/// The name of the email template.
/// The subject of the email template.
/// The HTML content of the email template.
/// The text content of the email template.
/// True if successful.
public async Task CreateEmailTemplateAsync(string templateName, string subject, string htmlContent, string textContent)
{
var request = new CreateEmailTemplateRequest
{
TemplateName = templateName,
TemplateContent = new EmailTemplateContent
{
Subject = subject,
Html = htmlContent,
Text = textContent
}
};
try
{
var response = await _sesClient.CreateEmailTemplateAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Email template with name {templateName} already exists.");
Console.WriteLine(ex.Message);
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for email templates has been exceeded.");
Console.WriteLine(ex.Message);
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the email template: {ex.Message}");
}
return false;
}
```
+ For API details, see [CreateEmailTemplate](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateEmailTemplate) in *AWS SDK for .NET API Reference*.
------
#### [ Java ]
**SDK for Java 2.x**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/ses#code-examples).
```
try {
// Create an email template named "weekly-coupons"
String newsletterHtml = loadFile("resources/coupon_newsletter/coupon-newsletter.html");
String newsletterText = loadFile("resources/coupon_newsletter/coupon-newsletter.txt");
CreateEmailTemplateRequest templateRequest = CreateEmailTemplateRequest.builder()
.templateName(TEMPLATE_NAME)
.templateContent(EmailTemplateContent.builder()
.subject("Weekly Coupons Newsletter")
.html(newsletterHtml)
.text(newsletterText)
.build())
.build();
sesClient.createEmailTemplate(templateRequest);
System.out.println("Email template created: " + TEMPLATE_NAME);
} catch (AlreadyExistsException e) {
// If the template already exists, skip this step and proceed with the next
// operation
System.out.println("Email template already exists, skipping creation...");
} catch (LimitExceededException e) {
// If the limit for email templates is exceeded, fail the workflow and inform
// the user
System.err.println("You have reached the limit for email templates. Please remove some templates and try again.");
throw e;
} catch (Exception e) {
System.err.println("Error occurred while creating email template: " + e.getMessage());
throw e;
}
```
+ For API details, see [CreateEmailTemplate](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateEmailTemplate) in *AWS SDK for Java 2.x API Reference*.
------
#### [ Python ]
**SDK for Python (Boto3)**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python/example_code/sesv2#code-examples).
```
def main():
"""
The main function that orchestrates the execution of the workflow.
"""
print(INTRO)
ses_client = boto3.client("sesv2")
workflow = SESv2Workflow(ses_client)
try:
workflow.prepare_application()
workflow.gather_subscriber_email_addresses()
workflow.send_coupon_newsletter()
workflow.monitor_and_review()
except ClientError as e:
print_error(e)
workflow.clean_up()
class SESv2Workflow:
"""
A class to manage the SES v2 Coupon Newsletter Workflow.
"""
def __init__(self, ses_client, sleep=True):
self.ses_client = ses_client
self.sleep = sleep
try:
template_content = {
"Subject": "Weekly Coupons Newsletter",
"Html": load_file_content("coupon-newsletter.html"),
"Text": load_file_content("coupon-newsletter.txt"),
}
self.ses_client.create_email_template(
TemplateName=TEMPLATE_NAME, TemplateContent=template_content
)
print(f"Email template '{TEMPLATE_NAME}' created successfully.")
except ClientError as e:
# If the template already exists, skip and proceed
if e.response["Error"]["Code"] == "AlreadyExistsException":
print(f"Email template '{TEMPLATE_NAME}' already exists.")
else:
raise e
```
+ For API details, see [CreateEmailTemplate](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateEmailTemplate) in *AWS SDK for Python (Boto3) API Reference*.
------
#### [ Rust ]
**SDK for Rust**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1/examples/ses#code-examples).
```
let template_html =
std::fs::read_to_string("../resources/newsletter/coupon-newsletter.html")
.unwrap_or_else(|_| "Missing coupon-newsletter.html".to_string());
let template_text =
std::fs::read_to_string("../resources/newsletter/coupon-newsletter.txt")
.unwrap_or_else(|_| "Missing coupon-newsletter.txt".to_string());
// Create the email template
let template_content = EmailTemplateContent::builder()
.subject("Weekly Coupons Newsletter")
.html(template_html)
.text(template_text)
.build();
match self
.client
.create_email_template()
.template_name(TEMPLATE_NAME)
.template_content(template_content)
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email template created successfully.")?,
Err(e) => match e.into_service_error() {
CreateEmailTemplateError::AlreadyExistsException(_) => {
writeln!(
self.stdout,
"Email template already exists, skipping creation."
)?;
}
e => return Err(anyhow!("Error creating email template: {}", e)),
},
}
```
+ For API details, see [CreateEmailTemplate](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_email_template) in *AWS SDK for Rust API reference*.
------
#### [ SAP ABAP ]
**SDK for SAP ABAP**
There's more on GitHub. Find the complete example and learn how to set up and run in the [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap/services/se2#code-examples).
```
TRY.
DATA(lo_template_content) = NEW /aws1/cl_se2emailtmplcontent(
iv_subject = iv_subject
iv_html = iv_html
iv_text = iv_text ).
lo_se2->createemailtemplate(
iv_templatename = iv_template_name
io_templatecontent = lo_template_content ).
MESSAGE 'Email template created successfully.' TYPE 'I'.
CATCH /aws1/cx_se2alreadyexistsex.
MESSAGE 'Email template already exists.' TYPE 'I'.
CATCH /aws1/cx_se2badrequestex.
MESSAGE 'Bad request.' TYPE 'E'.
CATCH /aws1/cx_se2limitexceededex.
MESSAGE 'Limit exceeded.' TYPE 'E'.
ENDTRY.
```
+ For API details, see [CreateEmailTemplate](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP API reference*.
------