SESV2 / Client / create_contact

create_contact#

SESV2.Client.create_contact(**kwargs)#

Creates a contact, which is an end-user who is receiving the email, and adds them to a contact list.

See also: AWS API Documentation

Request Syntax

response = client.create_contact(
    ContactListName='string',
    EmailAddress='string',
    TopicPreferences=[
        {
            'TopicName': 'string',
            'SubscriptionStatus': 'OPT_IN'|'OPT_OUT'
        },
    ],
    UnsubscribeAll=True|False,
    AttributesData='string'
)
Parameters:
  • ContactListName (string) –

    [REQUIRED]

    The name of the contact list to which the contact should be added.

  • EmailAddress (string) –

    [REQUIRED]

    The contact’s email address.

  • TopicPreferences (list) –

    The contact’s preferences for being opted-in to or opted-out of topics.

    • (dict) –

      The contact’s preference for being opted-in to or opted-out of a topic.

      • TopicName (string) – [REQUIRED]

        The name of the topic.

      • SubscriptionStatus (string) – [REQUIRED]

        The contact’s subscription status to a topic which is either OPT_IN or OPT_OUT.

  • UnsubscribeAll (boolean) – A boolean value status noting if the contact is unsubscribed from all contact list topics.

  • AttributesData (string) – The attribute data attached to a contact.

Return type:

dict

Returns:

Response Syntax

{}

Response Structure

  • (dict) –

Exceptions

  • SESV2.Client.exceptions.BadRequestException

  • SESV2.Client.exceptions.TooManyRequestsException

  • SESV2.Client.exceptions.NotFoundException

  • SESV2.Client.exceptions.AlreadyExistsException