DocumentationExperience PlatformPrivacy Service Guide

Consent endpoint

Last update: Fri Jan 06 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer
  • User
  • Admin
  • Leader

Certain regulations require explicit customer consent before their personal data can be collected. The /consent endpoint in the Privacy Service API allows you to process customer consent requests and integrate them into your privacy workflow.

Before using this guide, please refer to the getting started guide for information on the required authentication headers presented in the example API call below.

Consent requests are processed by making a POST request to the /consent endpoint.

API format

POST /consent

Request

The following request creates a new consent job for the user IDs provided in the entities array.

curl -X POST \
  https://platform.adobe.io/data/core/privacy/consent \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -d '{
        "optOutOfSale": true,
        "entities": [
          {
            "nameSpace": "email",
            "values": [
              "dsmith@acme.com",
              "ajones@acme.com"
            ]
          },
          {
            "nameSpace": "ECID",
            "values": [
              "443636576799758681021090721276"
            ]
          }
        ]
      }'
Property
Description
optOutOfSale
When set to true, indicates that the users provided under entities wish to opt-out of the sale or sharing of their personal data.
entities
An array of objects indicating the users who the consent request applies to. Each object contains a namespace and an array of values to match individual users with that namespace.
nameSpace
Each object in the entities array must contain one of the standard identity namespaces recognized by the Privacy Service API.
values
An array of values for each user, corresponding with the provided nameSpace.
NOTE
For more information on how to determine which customer identity values to send to Privacy Service, see the guide on providing identity data.

Response

A successful response returns HTTP status 202 (Accepted) with no payload, indicating that the request was accepted by Privacy Service and is undergoing processing.

recommendation-more-help
9cbf7061-a312-49f7-aaf8-a10885d53580