Add/update contacts

The method adds new contacts and updates existing contacts.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Body Params
array of objects
required

The list of contacts that will be added or updated (max. 3000).
If this array of objects contains externalCustomerId, the search uses externalCustomerId and ignores dedupeOn.

contacts*
string
required

The property for determining uniqueness of a contact.

int64

The field for determining the contact uniqueness.
This field is taken into account when dedupeOnProperty has the fieldId value.

array of strings

The list of contacts’ fields to be updated. All the contact fields will be updated if this parameter is not specified.
The fields will be updated with the ‘null’ value if no data for updating is transmitted.

contactFields
array of int32s

The list of the custom field IDs to be updated.

The custom fields are updated if their IDs are in this list.

This field is required when a contact is updated

customFieldsIDs
array of strings

The list of the segment names where the new/updated contacts will be added to.

groupNames
array of strings

The list of the segment names where the new/updated contacts will be excluded from.

groupNamesExclude
boolean

Choose either to restore the previously deleted contacts or not.

string

The event type identification key. An event of corresponding type is generated for each contact.

If the system does not have an event type with such a key, a new event type is created.

All characters are allowed, except < ; ’ \ / | " ` ' ^ ? ! , >

Max length: 100 symbols

Responses

400

Bad request

401

Unauthorized

405

Method not allowed

415

Unsupported media type

429

Too many requests: More than 200 requests per 1 second

Language
Credentials
:
Click Try It! to start a request and see the response here! Or choose an example:
application/json; charset=UTF-8