POST /contacts/v1/contacts/preferences
Adds consent management information to contact records for data protection and privacy concerns. The request can include multiple contact IDs in a single JSON payload. For best performance, use batches of contact ID values whenever possible.
Name | Type | Description | |
---|---|---|---|
items | array | Required | Array of contact IDs and other properties to add. |
items.contactID | long | Required | Unique ID for the contact. |
items.hasOptedOutTracking | boolean | Indicates whether a contact opted out of tracking information. |
Status | Name | Type | Description |
---|---|---|---|
200 | Added contact preferences. | ||
items | array | Array of contact IDs and other properties to add. | |
items.contactID | long | Unique ID for the contact. | |
items.hasOptedOutTracking | boolean | Indicates whether a contact opted out of tracking information. | |
rowsInserted | integer | Number of preferences inserted. | |
rowsUpdated | integer | Number of preferences updated. | |
rowsDeleted | integer | Number of preferences deleted. | |
requestServiceMessageID | guid | Service message ID for the request. | |
responseDateTime | integer | Date and time of the retry response in UTC. | |
resultMessages | array | Array of messages about the request. Includes details, such as resulttype and resultcode, about a bad request. | |
serviceMessageID | guid | Service message ID for the response. |
To issue a request, you must have these permissions.
- Contacts | Read
- Contacts | Write
- Contacts | Access
- Documents and Images, Read and Write
- Saved Content, Read and Write