AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates an association between a configuration set and a custom domain for open and click event tracking.

By default, images and links used for tracking open and click events are hosted on domains operated by Amazon SES. You can configure a subdomain of your own to handle these events. For information about using custom domains, see the Amazon SES Developer Guide.


This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCreateConfigurationSetTrackingOptions and EndCreateConfigurationSetTrackingOptions.

Namespace: Amazon.SimpleEmail
Assembly: AWSSDK.SimpleEmail.dll
Version: 3.x.y.z


public abstract Task<CreateConfigurationSetTrackingOptionsResponse> CreateConfigurationSetTrackingOptionsAsync(
         CreateConfigurationSetTrackingOptionsRequest request,
         CancellationToken cancellationToken
Type: Amazon.SimpleEmail.Model.CreateConfigurationSetTrackingOptionsRequest

Container for the necessary parameters to execute the CreateConfigurationSetTrackingOptions service method.

Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value
The response from the CreateConfigurationSetTrackingOptions service method, as returned by SimpleEmailService.


ConfigurationSetDoesNotExistException Indicates that the configuration set does not exist.
InvalidTrackingOptionsException Indicates that the custom domain to be used for open and click tracking redirects is invalid. This error appears most often in the following situations: When the tracking domain you specified is not verified in Amazon SES. When the tracking domain you specified is not a valid domain or subdomain.
TrackingOptionsAlreadyExistsException Indicates that the configuration set you specified already contains a TrackingOptions object.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0, 1.3

.NET Framework:
Supported in: 4.5

See Also