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.
JSON Parameters
| 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. |
Responses
| 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. |
Required Marketing Cloud Permissions
- Assets, Upload
- Assets, Publish
Required Scope
- Documents and Images, Read and Write
- Saved Content, Read and Write
Example Request
Example Response