There are more AWS SDK examples available in the [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub repo.
# Use `CreateEmailIdentity` with an AWS SDK
The following code examples show how to use `CreateEmailIdentity`.
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 examples:
+ [Email Attachments Scenario](sesv2_example_sesv2_Scenario_EmailAttachments_section.md)
+ [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 identity (email address or domain) and starts the verification process.
///
/// The email address or domain to create and verify.
/// The response from the CreateEmailIdentity operation.
public async Task CreateEmailIdentityAsync(string emailIdentity)
{
var request = new CreateEmailIdentityRequest
{
EmailIdentity = emailIdentity
};
try
{
var response = await _sesClient.CreateEmailIdentityAsync(request);
return response;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Email identity {emailIdentity} already exists.");
Console.WriteLine(ex.Message);
throw;
}
catch (ConcurrentModificationException ex)
{
Console.WriteLine($"The email identity {emailIdentity} is being modified by another operation or thread.");
Console.WriteLine(ex.Message);
throw;
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for email identities has been exceeded.");
Console.WriteLine(ex.Message);
throw;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The email identity {emailIdentity} does not exist.");
Console.WriteLine(ex.Message);
throw;
}
catch (TooManyRequestsException ex)
{
Console.WriteLine("Too many requests were made. Please try again later.");
Console.WriteLine(ex.Message);
throw;
}
catch (Exception ex)
{
Console.WriteLine($"An error occurred while creating the email identity: {ex.Message}");
throw;
}
}
```
+ For API details, see [CreateEmailIdentity](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateEmailIdentity) 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 {
CreateEmailIdentityRequest createEmailIdentityRequest = CreateEmailIdentityRequest.builder()
.emailIdentity(verifiedEmail)
.build();
sesClient.createEmailIdentity(createEmailIdentityRequest);
System.out.println("Email identity created: " + verifiedEmail);
} catch (AlreadyExistsException e) {
System.out.println("Email identity already exists, skipping creation: " + verifiedEmail);
} catch (NotFoundException e) {
System.err.println("The provided email address is not verified: " + verifiedEmail);
throw e;
} catch (LimitExceededException e) {
System.err
.println("You have reached the limit for email identities. Please remove some identities and try again.");
throw e;
} catch (SesV2Exception e) {
System.err.println("Error creating email identity: " + e.getMessage());
throw e;
}
```
+ For API details, see [CreateEmailIdentity](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateEmailIdentity) 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/attachments_scenario#code-examples).
```
class SESv2Wrapper:
"""Encapsulates Amazon SESv2 email sending actions."""
def __init__(self, sesv2_client: Any) -> None:
"""
Initializes the SESv2Wrapper with an SESv2 client.
:param sesv2_client: A Boto3 SESv2 client.
"""
self.sesv2_client = sesv2_client
@classmethod
def from_client(cls) -> "SESv2Wrapper":
"""
Creates an SESv2Wrapper instance with a default Boto3 SESv2 client.
:return: A new SESv2Wrapper instance.
"""
sesv2_client = boto3.client("sesv2")
return cls(sesv2_client)
def create_email_identity(self, email_address: str) -> Dict[str, Any]:
"""
Starts the process of verifying an email identity (email address or domain).
:param email_address: The email address or domain to verify.
:return: A dictionary with the identity type and verification status.
:raises ClientError: If the limit is exceeded (LimitExceededException).
"""
try:
response = self.sesv2_client.create_email_identity(
EmailIdentity=email_address
)
logger.info(
"Started verification for email identity %s.", email_address
)
return response
except ClientError as err:
if err.response["Error"]["Code"] == "LimitExceededException":
logger.error(
"Couldn't create email identity %s. You have exceeded "
"the maximum number of email identities. "
"Use an existing verified identity.",
email_address,
)
else:
logger.error(
"Couldn't create email identity %s. Here's why: %s: %s",
email_address,
err.response["Error"]["Code"],
err.response["Error"]["Message"],
)
raise
```
+ For API details, see [CreateEmailIdentity](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateEmailIdentity) in *AWS SDK for Python (Boto3) API Reference*.
**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/newsletter_scenario#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:
self.ses_client.create_email_identity(EmailIdentity=self.verified_email)
print(f"Email identity '{self.verified_email}' created successfully.")
except ClientError as e:
# If the email identity already exists, skip and proceed
if e.response["Error"]["Code"] == "AlreadyExistsException":
print(f"Email identity '{self.verified_email}' already exists.")
else:
raise e
```
+ For API details, see [CreateEmailIdentity](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateEmailIdentity) 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).
```
match self
.client
.create_email_identity()
.email_identity(self.verified_email.clone())
.send()
.await
{
Ok(_) => writeln!(self.stdout, "Email identity created successfully.")?,
Err(e) => match e.into_service_error() {
CreateEmailIdentityError::AlreadyExistsException(_) => {
writeln!(
self.stdout,
"Email identity already exists, skipping creation."
)?;
}
e => return Err(anyhow!("Error creating email identity: {}", e)),
},
}
```
+ For API details, see [CreateEmailIdentity](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_email_identity) 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.
lo_se2->createemailidentity(
iv_emailidentity = iv_email_identity ).
MESSAGE 'Email identity created successfully.' TYPE 'I'.
CATCH /aws1/cx_se2alreadyexistsex.
MESSAGE 'Email identity already exists.' TYPE 'I'.
CATCH /aws1/cx_se2badrequestex INTO DATA(lo_bad_request).
MESSAGE lo_bad_request TYPE 'I' DISPLAY LIKE 'E'.
CATCH /aws1/cx_se2limitexceededex INTO DATA(lo_limit_exceeded).
MESSAGE lo_limit_exceeded TYPE 'I' DISPLAY LIKE 'E'.
ENDTRY.
```
+ For API details, see [CreateEmailIdentity](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP API reference*.
------