:doc:`SES <../../ses>` / Client / create_configuration_set_tracking_options

*****************************************
create_configuration_set_tracking_options
*****************************************



.. py:method:: SES.Client.create_configuration_set_tracking_options(**kwargs)

  

  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 <https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html>`__.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/email-2010-12-01/CreateConfigurationSetTrackingOptions>`_  


  **Request Syntax**
  ::

    response = client.create_configuration_set_tracking_options(
        ConfigurationSetName='string',
        TrackingOptions={
            'CustomRedirectDomain': 'string'
        }
    )
    
  :type ConfigurationSetName: string
  :param ConfigurationSetName: **[REQUIRED]** 

    The name of the configuration set that the tracking options should be associated with.

    

  
  :type TrackingOptions: dict
  :param TrackingOptions: **[REQUIRED]** 

    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 <https://docs.aws.amazon.com/ses/latest/dg/configure-custom-open-click-domains.html>`__ in the *Amazon SES Developer Guide*.

    

  
    - **CustomRedirectDomain** *(string) --* 

      The custom subdomain that is used to redirect email recipients to the Amazon SES event tracking domain.

      

    
  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 

      An empty element returned on a successful request.

      
  
  **Exceptions**
  
  *   :py:class:`SES.Client.exceptions.ConfigurationSetDoesNotExistException`

  
  *   :py:class:`SES.Client.exceptions.TrackingOptionsAlreadyExistsException`

  
  *   :py:class:`SES.Client.exceptions.InvalidTrackingOptionsException`

  