Sign in

v1

latestOpenAPI 3.1.0Apache 2.02026-07-245981,1853.0 MB
Consent Groups

Create Consent Group

Use this API to create a new Consent Group by providing a name, description, and optional external name.

🗒 Things to Know

  • If an external name is not defined, one will be generated automatically.
post/api/consent/v2/consent-groups

Request body

namestring

The Consent Group name

descriptionstring

A description of the Consent Group

externalNamestring

The Consent Group's external name. If not provided, this will be generated based on the name

Example request

{
  "name": "OneTrust Atlanta",
  "description": "Consent for the company OneTrust, specifically for the Atlanta Office. Contains subsidiary data subjects representing OneTrust employees that work at this location.",
  "externalName": "onetrust_atlanta"
}

Response

Consent Group created successfully.

namestring

The Consent Group name

descriptionstring

A description of the Consent Group

externalNamestring

The Consent Group's external name. If not provided, this will be generated based on the name

consentGroupIdstring uuid

Unique identifier identifying a Consent Group

membershipType'EMPTY' | 'CHILD_GROUPS' | 'DATA_SUBJECTS'

Indicates whether the consent group has other consent groups as its children, or if it has data subjects associated to it

Example response

{
  "name": "OneTrust Atlanta",
  "description": "Consent for the company OneTrust, specifically for the Atlanta Office. Contains subsidiary data subjects representing OneTrust employees that work at this location.",
  "externalName": "onetrust_atlanta",
  "consentGroupId": "2a644966-fe93-4561-b71a-f0dda4396459",
  "membershipType": "CHILD_GROUPS",
  "purposeRules": [
    {
      "purposeId": "f2229953-b4b5-4042-8cb9-b78038cc4c46",
      "enforcedStatus": "ACTIVE",
      "effectiveStatus": "OPT_OUT"
    }
  ],
  "dataSubjects": [
    {
      "id": "633ba071-61b0-485f-81a0-a2245777b432",
      "identifier": "example@otprivacy.com",
      "purposes": [
        {
          "id": "f2229953-b4b5-4042-8cb9-b78038cc4c46",
          "version": 2,
          "status": "ACTIVE",
          "effectiveStatus": "OPT_OUT"
        }
      ]
    }
  ],
  "consentGroups": [
    {
      "name": "OneTrust Atlanta",
      "description": "Consent for the company OneTrust, specifically for the Atlanta Office. Contains subsidiary data subjects representing OneTrust employees that work at this location.",
      "externalName": "onetrust_atlanta",
      "consentGroupId": "2a644966-fe93-4561-b71a-f0dda4396459",
      "membershipType": "CHILD_GROUPS"
    }
  ]
}