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