There are more AWS SDK examples available in the [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub repo.
# Use `CreateContactList` with an AWS SDK
The following code examples show how to use `CreateContactList`.
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 list with the specified name.
///
/// The name of the contact list.
/// True if successful.
public async Task CreateContactListAsync(string contactListName)
{
var request = new CreateContactListRequest
{
ContactListName = contactListName
};
try
{
var response = await _sesClient.CreateContactListAsync(request);
return response.HttpStatusCode == HttpStatusCode.OK;
}
catch (AlreadyExistsException ex)
{
Console.WriteLine($"Contact list with name {contactListName} already exists.");
Console.WriteLine(ex.Message);
return true;
}
catch (LimitExceededException ex)
{
Console.WriteLine("The limit for contact lists 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 contact list: {ex.Message}");
}
return false;
}
```
+ For API details, see [CreateContactList](https://docs.aws.amazon.com/goto/DotNetSDKV3/sesv2-2019-09-27/CreateContactList) 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 {
// 2. Create a contact list
String contactListName = CONTACT_LIST_NAME;
CreateContactListRequest createContactListRequest = CreateContactListRequest.builder()
.contactListName(contactListName)
.build();
sesClient.createContactList(createContactListRequest);
System.out.println("Contact list created: " + contactListName);
} catch (AlreadyExistsException e) {
System.out.println("Contact list already exists, skipping creation: weekly-coupons-newsletter");
} catch (LimitExceededException e) {
System.err.println("Limit for contact lists has been exceeded.");
throw e;
} catch (SesV2Exception e) {
System.err.println("Error creating contact list: " + e.getMessage());
throw e;
}
```
+ For API details, see [CreateContactList](https://docs.aws.amazon.com/goto/SdkForJavaV2/sesv2-2019-09-27/CreateContactList) 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:
self.ses_client.create_contact_list(ContactListName=CONTACT_LIST_NAME)
print(f"Contact list '{CONTACT_LIST_NAME}' created successfully.")
except ClientError as e:
# If the contact list already exists, skip and proceed
if e.response["Error"]["Code"] == "AlreadyExistsException":
print(f"Contact list '{CONTACT_LIST_NAME}' already exists.")
else:
raise e
```
+ For API details, see [CreateContactList](https://docs.aws.amazon.com/goto/boto3/sesv2-2019-09-27/CreateContactList) 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 make_list(client: &Client, contact_list: &str) -> Result<(), Error> {
client
.create_contact_list()
.contact_list_name(contact_list)
.send()
.await?;
println!("Created contact list.");
Ok(())
}
```
+ For API details, see [CreateContactList](https://docs.rs/aws-sdk-sesv2/latest/aws_sdk_sesv2/client/struct.Client.html#method.create_contact_list) 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->createcontactlist(
iv_contactlistname = iv_contact_list_name ).
MESSAGE 'Contact list created successfully.' TYPE 'I'.
CATCH /aws1/cx_se2alreadyexistsex.
MESSAGE 'Contact list already exists.' TYPE 'I'.
CATCH /aws1/cx_se2badrequestex INTO DATA(lo_bad_request).
MESSAGE 'Bad request - contact list limit may be reached.' TYPE 'I'.
" Re-raise the exception so the caller can handle it
RAISE EXCEPTION lo_bad_request.
CATCH /aws1/cx_se2limitexceededex INTO DATA(lo_limit_exceeded).
MESSAGE 'Limit exceeded - contact list limit reached.' TYPE 'I'.
" Re-raise the exception so the caller can handle it
RAISE EXCEPTION lo_limit_exceeded.
ENDTRY.
```
+ For API details, see [CreateContactList](https://docs.aws.amazon.com/sdk-for-sap-abap/v1/api/latest/index.html) in *AWS SDK for SAP ABAP API reference*.
------