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

*********************************************
set_identity_headers_in_notifications_enabled
*********************************************



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

  

  Given an identity (an email address or a domain), sets whether Amazon SES includes the original email headers in the Amazon Simple Notification Service (Amazon SNS) notifications of a specified type.

   

  You can execute this operation no more than once per second.

   

  For more information about using notifications with Amazon SES, see the `Amazon SES Developer Guide <https://docs.aws.amazon.com/ses/latest/dg/monitor-sending-activity-using-notifications.html>`__.

  

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


  **Request Syntax**
  ::

    response = client.set_identity_headers_in_notifications_enabled(
        Identity='string',
        NotificationType='Bounce'|'Complaint'|'Delivery',
        Enabled=True|False
    )
    
  :type Identity: string
  :param Identity: **[REQUIRED]** 

    The identity for which to enable or disable headers in notifications. Examples: ``user@example.com``, ``example.com``.

    

  
  :type NotificationType: string
  :param NotificationType: **[REQUIRED]** 

    The notification type for which to enable or disable headers in notifications.

    

  
  :type Enabled: boolean
  :param Enabled: **[REQUIRED]** 

    Sets whether Amazon SES includes the original email headers in Amazon SNS notifications of the specified notification type. A value of ``true`` specifies that Amazon SES includes headers in notifications, and a value of ``false`` specifies that Amazon SES does not include headers in notifications.

     

    This value can only be set when ``NotificationType`` is already set to use a particular Amazon SNS topic.

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 

      An empty element returned on a successful request.

      
  

  **Examples**

  The following example configures Amazon SES to include the original email headers in the Amazon SNS bounce notifications for an identity:
  ::

    response = client.set_identity_headers_in_notifications_enabled(
        Enabled=True,
        Identity='user@example.com',
        NotificationType='Bounce',
    )
    
    print(response)

  
  Expected Output:
  ::

    {
        'ResponseMetadata': {
            '...': '...',
        },
    }

  