create_contact

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