POST /contacts/v1/contacts

Overview

Creates a new contact with the specified information in the specified attribute groups.

JSON Parameters

NameTypeDescription
contactKeystringPrimary address for the contact. You must provide either a value for contactKey or contactID.
contactIDstringUnique ID for the contact. You must provide either a value for contactKey or contactID.
attributeSetsarrayRequiredArray of information used to create a new contact
attributeSets.namestringRequiredName of attribute group to which to add the contact information
attributeSets.valuesarrayName and value pairs indicating the attribute and applicable value

Usage

Example Request

The request must include at least one of the attribute sets to create a new contact:

  • Email Addresses (You must also include this attribute set if you include Email Demographics)
  • MobileConnect Demographics (You must include a country code for the Locale value)
  • MobilePush Demographics (You must include an ApplicationID value)
  • LINE Addresses and LINE Subscriptions (You must also include these attribute sets if you include LINE Demographics)

WhatsApp is not supported.

Each call accepts only one instance of each attribute set.

You must also include values for contactKey and HTML Enabled.

Change @example.com to a valid domain.

Example Response