Amazon Simple Email Service
API Reference (API Version 2010-12-01)

UpdateConfigurationSetTrackingOptions

Modifies 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.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

ConfigurationSetName

The name of the configuration set for which you want to update the custom tracking domain.

Type: String

Required: Yes

TrackingOptions

A domain that is used to redirect email recipients to an Amazon SES-operated domain. This domain captures open and click events generated by Amazon SES emails.

For more information, see Configuring Custom Domains to Handle Open and Click Tracking in the Amazon SES Developer Guide.

Type: TrackingOptions object

Required: Yes

Errors

For information about the errors that are common to all actions, see Common Errors.

ConfigurationSetDoesNotExist

Indicates that the configuration set does not exist.

HTTP Status Code: 400

InvalidTrackingOptions

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.

HTTP Status Code: 400

TrackingOptionsDoesNotExist

Indicates that the TrackingOptions object you specified does not exist.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: