There are more AWS SDK examples available in the [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub repo.
# Use `CreateContact` with an AWS SDK
The following code examples show how to use `CreateContact`.
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 a contact and adds it to the specified contact list.
///
/// The email address of the contact.
/// The name of the contact list.
/// The response from the CreateContact operation.
public async Task CreateContactAsync(string emailAddress, string contactListName)
{
var request = new CreateContactRequest
{
EmailAddress = emailAddress,
ContactListName = contactListName
};
try
{
var response = await _sesClient.CreateContactAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Contact with email address {emailAddress} already exists in the contact list {contactListName}.");
Console.WriteLine(ex.Message);
return true;
}
catch (NotFoundException ex)
{
Console.WriteLine($"The contact list {contactListName} does not exist.");
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 contact: {ex.Message}");
}
return false;
}
```
+ For API details, see [CreateContact](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateContact) 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 a new contact with the provided email address in the
CreateContactRequest contactRequest = CreateContactRequest.builder()
.contactListName(CONTACT_LIST_NAME)
.emailAddress(emailAddress)
.build();
sesClient.createContact(contactRequest);
contacts.add(emailAddress);
System.out.println("Contact created: " + emailAddress);
// Send a welcome email to the new contact
String welcomeHtml = Files.readString(Paths.get("resources/coupon_newsletter/welcome.html"));
String welcomeText = Files.readString(Paths.get("resources/coupon_newsletter/welcome.txt"));
SendEmailRequest welcomeEmailRequest = SendEmailRequest.builder()
.fromEmailAddress(this.verifiedEmail)
.destination(Destination.builder().toAddresses(emailAddress).build())
.content(EmailContent.builder()
.simple(
Message.builder()
.subject(Content.builder().data("Welcome to the Weekly Coupons Newsletter").build())
.body(Body.builder()
.text(Content.builder().data(welcomeText).build())
.html(Content.builder().data(welcomeHtml).build())
.build())
.build())
.build())
.build();
SendEmailResponse welcomeEmailResponse = sesClient.sendEmail(welcomeEmailRequest);
System.out.println("Welcome email sent: " + welcomeEmailResponse.messageId());
} catch (AlreadyExistsException e) {
// If the contact already exists, skip this step for that contact and proceed
// with the next contact
System.out.println("Contact already exists, skipping creation...");
} catch (Exception e) {
System.err.println("Error occurred while processing email address " + emailAddress + ": " + e.getMessage());
throw e;
}
}
```
+ For API details, see [CreateContact](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateContact) 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:
# Create a new contact
self.ses_client.create_contact(
ContactListName=CONTACT_LIST_NAME, EmailAddress=email
)
print(f"Contact with email '{email}' created successfully.")
# Send the welcome email
self.ses_client.send_email(
FromEmailAddress=self.verified_email,
Destination={"ToAddresses": [email]},
Content={
"Simple": {
"Subject": {
"Data": "Welcome to the Weekly Coupons Newsletter"
},
"Body": {
"Text": {"Data": welcome_text},
"Html": {"Data": welcome_html},
},
}
},
)
print(f"Welcome email sent to '{email}'.")
if self.sleep:
# 1 email per second in sandbox mode, remove in production.
sleep(1.1)
except ClientError as e:
# If the contact already exists, skip and proceed
if e.response["Error"]["Code"] == "AlreadyExistsException":
print(f"Contact with email '{email}' already exists. Skipping...")
else:
raise e
```
+ For API details, see [CreateContact](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateContact) 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).
```
async fn add_contact(client: &Client, list: &str, email: &str) -> Result<(), Error> {
client
.create_contact()
.contact_list_name(list)
.email_address(email)
.send()
.await?;
println!("Created contact");
Ok(())
}
```
+ For API details, see [CreateContact](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_contact) 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->createcontact(
iv_contactlistname = iv_contact_list_name
iv_emailaddress = iv_email_address ).
MESSAGE 'Contact created successfully.' TYPE 'I'.
CATCH /aws1/cx_se2alreadyexistsex.
MESSAGE 'Contact already exists.' TYPE 'I'.
CATCH /aws1/cx_se2badrequestex.
MESSAGE 'Bad request.' TYPE 'E'.
CATCH /aws1/cx_se2notfoundexception.
MESSAGE 'Contact list not found.' TYPE 'E'.
ENDTRY.
```
+ For API details, see [CreateContact](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP API reference*.
------