Collection Points
Create Collection Point
Use this API to create a new Collection Point. The Collection Point will be created with version 1 and Draft status.
🗒 Things to Know
- Data element name values support up to 750 characters. Data element types containing the word Country do not support the following characters: [<>();:'“$#}{]
- If the EnablePrimaryIdentifier parameter is set to true, then the PrimaryIdentifierType parameter will be required in the API request body.
- When creating a Web Form Collection Point, the HostedSDK parameter value will be set to true by default, regardless of the value entered in the request body.
- One of the following parameters is required in the API request body: PurposeId, PurposeIds, or PurposeIdsWithVersion.
- The PurposeId and PurposeIds parameters can be used to link an Active version of a purpose to a Collection Point.
- The PurposeIdsWithVersion parameter can be used to link specific versions of a purpose (either in Draft or Active status) to a Collection Point.
post/api/consentmanager/v1/collectionpoints
Request body
Example request
{
"OrganizationId": "92cf3a3a-09a9-4d04-b69d-ea5bb1db550a",
"PurposeId": "f2229953-b4b5-4042-8cb9-b78038cc4c46,a6d68a29-a185-40e8-ac4c-5656d4856b0a",
"PurposeIds": [
"f2229953-b4b5-4042-8cb9-b78038cc4c46",
"a6d68a29-a185-40e8-ac4c-5656d4856b0a"
],
"Name": "Website Consent Banner",
"Description": "This collection point is used to collect consent for marketing cookies on the main website.",
"WebFormUrl": "https://example.com/consent-form",
"PrivacyPolicyUrl": "https://example.com/privacy-policy",
"SubjectIdentifier": "Email",
"IdentifierDataElementId": "7912bfe1-37dd-4180-8b99-963e80f3e125",
"ConsentType": "EXPLICIT",
"CollectionPointType": "WEB_FORM",
"DataControllerName": "Acme Corp",
"RightToWithdraw": "You have the right to withdraw your consent at any time.",
"HowToWithdraw": "To withdraw your consent, please contact our Data Protection Officer at dpo@example.com.",
"OtherInformation": "Processing is necessary for the performance of a contract to which the data subject is party.",
"RedirectUrl": "https://example.com/thank-you",
"IABVendorId": 13,
"DataElements": [
"marketing",
"analytics",
"preferences"
],
"Language": "en-us",
"PreferenceCenterGuid": "09ccd1b9-84a0-4bcb-a167-f761391ebffa",
"ResponsibleUserId": "bc4836e2-c117-461b-a7a2-2b268c037a97",
"ResponsibleGroupId": "5466af43-ff42-4a39-8722-5a98e7981fc4",
"OverrideActivePurpose": true,
"attributeValues": {
"customField1": [
{
"value": "example",
"dataType": "string"
}
]
},
"HostedWebForm": {
"Id": "123e4567-e89b-12d3-a456-426614174000",
"Name": "Main Consent Form",
"SdkVersion": "1.0.0",
"PublishedLink": "https://example.com/consent-form/published",
"DraftLink": "https://example.com/consent-form/draft",
"VersionId": "b6e376c3-e838-439f-a01b-1af24cf9a5ac",
"DefaultLanguageTranslations": {
"en": "English",
"es": "Spanish"
},
"PortalData": {
"DefaultLanguage": "en",
"SelectedLanguage": [
"en",
"es",
"fr"
],
"CustomTranslations": {
"es": {
"welcome.message": "Bienvenido"
},
"fr": {
"welcome.message": "Bienvenue"
}
}
},
"TestScriptGuid": "65840dad-c063-48d1-82e0-b9ec79f27908",
"ProdScriptGuid": "2defe229-42b9-4a16-85be-7e9610240d31",
"previewId": "f7cd1221-04a1-4523-89bf-3430c91b5cc9",
"TestPublishVersion": "1.0.0",
"ProdPublishVersion": "1.0.1",
"supportedScriptVersion": [
"1.0.0",
"2.0.0"
],
"NewSelectedLanguages": [
"en",
"es",
"fr"
],
"IntegrationUrls": [
"https://example.com/integration1",
"https://example.com/integration2"
],
"IntegrationSettings": {
"analytics": {
"enabled": true
},
"crm": {
"enabled": false
}
},
"formTemplate": "default-template"
},
"PurposeIdsWithVersion": [
{
"id": "7912bfe1-37dd-4180-8b99-963e80f3e125",
"version": 1
}
],
"PrimaryIdentifierType": "Email",
"CookieConsentUpdate": "UPDATE_ALL",
"ParentIdentifierTypes": [
"Email",
"Mobile"
],
"DOIEmailIdentifier": "user@example.com",
"AckEmailIdentifier": "acknowledgment@example.com",
"PrefillIdentifier": "user@example.com"
}Response
Collection Point created successfully
Example response
{
"jwtToken": "null",
"noticesWithVersions": [
"id",
"name",
"privacyNoticeGuid"
],
"Id": "25d9ccac-db88-4d34-849c-3d602a629961",
"Version": 2,
"Name": "Web Form Collection Point",
"CollectionPointType": "WEB_FORM",
"ConsentType": "FORMSUBMIT",
"Status": "ACTIVE",
"SubjectIdentifier": "Email",
"IdentifierDataElement": {
"Id": "21e0de87-d6ef-4b39-a54b-6d877698e3f6",
"Label": "Work Email",
"Languages": [
{
"Name": "Work Email",
"DataElementOptions": [
{
"Id": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed",
"Label": "Option 1"
}
],
"Language": "en-us"
}
],
"NumberOfLanguages": 3,
"CreatedDate": "2019-12-30T10:52:30.974Z",
"UpdatedDate": "2019-12-30T10:55:30.974Z",
"CollectionPoints": 2,
"CollectionPointsWithoutRetired": 2,
"totalActivePreferenceCenters": 2,
"PreferenceCenters": 2,
"Organizations": [
"712a1f61-a548-432f-afc4-5a383c28eeb2",
"862a1f61-e148-032f-afc4-7a383c28eec6"
]
},
"ReceiptCount": 563,
"Description": "Collecting data for Marketing and Promotion Purposes",
"WebFormUrl": "https://www.onetrust.com/",
"PrivacyPolicyUrl": "https://www.onetrust.com/privacy-notice",
"OrganizationId": "92cf3a3a-09a9-4d04-b69d-ea5bb1db550a",
"RedirectUrl": "https://www.onetrust.com/",
"IABVendorId": 13,
"Language": "en-us",
"Languages": [
"en-us",
"fr"
],
"PreferenceCenter": {
"Id": "09ccd1b9-84a0-4bcb-a167-f761391ebffa",
"Name": "Email Communication Preferences",
"OrganizationName": "OneTrust",
"Template": "ENHANCED"
},
"ResponsibleUserId": "bc4836e2-c117-461b-a7a2-2b268c037a97",
"ResponsibleGroupId": "5466af43-ff42-4a39-8722-5a98e7981fc4",
"LastModifiedBy": "304F7D36-75A2-4967-81A5-5A7D604C6A19",
"PublishedBy": "304F7D36-75A2-4967-81A5-5A7D604C6A19",
"PrimaryIdentifierType": "Email",
"EnableGeolocation": true,
"EnableGeoLocationForDataElements": true,
"EnablePrefillIdentifier": true,
"RedirectOnFormSubmission": true,
"DisableReports": true,
"enablePurposeEvent": true,
"enableDataElementEvent": true,
"enableCustomPreferenceEvent": true,
"DataElements": [
"First Name",
"Last Name",
"Work Email"
],
"IdentifierTypes": [
"Email",
"Mobile"
],
"AllowMultipleIdentifierTypes": true,
"CanCreateNewVersion": true,
"HostedWebForm": {
"Id": "123e4567-e89b-12d3-a456-426614174000",
"Name": "Main Consent Form",
"SdkVersion": "1.0.0",
"PublishedLink": "https://example.com/consent-form/published",
"DraftLink": "https://example.com/consent-form/draft",
"VersionId": "b6e376c3-e838-439f-a01b-1af24cf9a5ac",
"DefaultLanguageTranslations": {
"en": "English",
"es": "Spanish"
},
"PortalData": {
"DefaultLanguage": "en",
"SelectedLanguage": [
"en",
"es",
"fr"
],
"CustomTranslations": {
"es": {
"welcome.message": "Bienvenido"
},
"fr": {
"welcome.message": "Bienvenue"
}
}
},
"TestScriptGuid": "65840dad-c063-48d1-82e0-b9ec79f27908",
"ProdScriptGuid": "2defe229-42b9-4a16-85be-7e9610240d31",
"previewId": "f7cd1221-04a1-4523-89bf-3430c91b5cc9",
"TestPublishVersion": "1.0.0",
"ProdPublishVersion": "1.0.1",
"supportedScriptVersion": [
"1.0.0",
"2.0.0"
],
"NewSelectedLanguages": [
"en",
"es",
"fr"
],
"IntegrationUrls": [
"https://example.com/integration1",
"https://example.com/integration2"
],
"IntegrationSettings": {
"analytics": {
"enabled": true
},
"crm": {
"enabled": false
}
},
"formTemplate": "default-template"
},
"CookieConsentUpdate": "SKIP_TRANSACTION, UPDATE_ALL",
"ParentIdentifierTypes": [
"First Name",
"Last Name",
"Address"
],
"DOIEmailIdentifier": "test@ot.com",
"AckEmailIdentifier": "testack@ot.com",
"PrefillIdentifier": "randomId",
"Purposes": [
{
"Id": "f2229953-b4b5-4042-8cb9-b78038cc4c46",
"Label": "Marketing Communications",
"Description": "Collect customer emails for marketing purposes",
"Status": "ACTIVE",
"NewVersionAvailable": true,
"Type": "STANDARD",
"LifeSpan": 7889238,
"ImplicitConsentConfirmDesc": "I can confirm",
"PurposeCategory": {
"id": "a34ccec7-1ec0-4d65-9075-bdd0d923f1d1",
"value": "Text Value",
"valueKey": "attribute.option.valueKey",
"colorCode": "red",
"optionSelectionValue": "\"3.5\"",
"displayLabel": "United State | San Francisco",
"associatedAttributeValueInformation": [
{
"id": "a34ccec7-1ec0-4d65-9075-bdd0d923f1d1",
"value": "Text Value",
"valueKey": "attribute.option.valueKey",
"colorCode": "red"
}
]
},
"Version": 2,
"ParentPurposeId": "ba54eb25-90f0-4633-ab12-c7bf5afdd856",
"includeParameter": "false",
"CreatedDate": "2019-12-30T10:52:30.974Z",
"UpdatedBy": "304F7D36-75A2-4967-81A5-5A7D604C6A19",
"UpdatedDate": "2019-12-30T10:54:30.974Z",
"PublishedBy": "304F7D36-75A2-4967-81A5-5A7D604C6A19",
"PublishedDate": "2019-12-30T10:54:30.974Z",
"Topics": [
{
"Id": "497c4383-2c61-4906-aed0-660e3fd03ef0",
"Name": "Car Marketing",
"IntegrationKey": "Marketing-Communications_Car-Marketing",
"CanDelete": true
}
],
"CustomPreferences": [
{
"Id": "194e0d3b-0ba8-4bc7-b046-e3ae42b2bd25",
"Name": "Email Frequency",
"Description": "Options for different frequencies to receive emails",
"SelectionType": "SINGLE_CHOICE",
"DisplayAs": "BUTTONs",
"CreatedDate": "2023-01-15T10:52:30.974Z",
"UpdatedDate": "2023-01-15T10:55:30.974Z",
"NumberOfOptions": 4,
"NumberOfLanguages": 3,
"DefaultLanguage": "en-us",
"Options": [
{
"Id": "ca0fc41b-b28a-4335-804c-44d1f0f782ed",
"Label": "Weekly",
"Order": 1,
"IsDefault": true,
"CanDelete": true
}
],
"Languages": [
{
"Name": "Email Frequency",
"Description": "Options for different frequencies to receive emails",
"Language": "en-us",
"Default": true,
"Options": [
{
"Id": "ca0fc41b-b28a-4335-804c-44d1f0f782ed",
"Label": "Weekly",
"Order": 1,
"IsDefault": true,
"CanDelete": true
}
]
}
],
"Organizations": [
"712a1f61-a548-432f-afc4-5a383c28eeb2"
],
"TotalLinkedActivePurposes": 5,
"PurposeCustomPreferenceId": "c4a57a38-3774-45ad-9fa4-dbc545542232"
}
],
"PurposeLanguages": [
{
"Name": "Marketing Communications",
"Description": "Collect customer emails for marketing purposes",
"Description of Implicit Purpose Confirmation checkbox": "I can confirm",
"Language": "en-us",
"Default": true,
"HardOptOutMessage": "This purpose is required and cannot be opted out"
}
],
"EnableGeolocation": true,
"LastMajorVersion": 5,
"VersionNotes": "Added new consent options",
"IsMajorVersion": true,
"HardOptOutDisplayFormat": "HIDE",
"HardOptOutMessage": "This purpose is required and cannot be opted out"
}
]
}