Bulk Exporting Consent Records
You can bulk export consent records in two ways:
-
Create bulk export files within the Bulk export tab of the Universal Consent & Preference Management menu.
-
Use integration workflows to automate bulk export events to push updates from your OneTrust tenant to third-party systems. Currently, there is one event available for use within the Integrations menu, which requires additional settings and configuration in other parts of the application.
To bulk export consent records from the OneTrust application
By default, bulk exports are limited to 20 credits/month per tenant. If you require more export credits, please contact OneTrust Support. Export credits can be increased for production environments only.
The following permissions are required to export consent record fro the OneTrust application.
|
Permission name |
Description |
System roles |
Custom roles |
|---|---|---|---|
|
Create bulk exports for consent receipts |
Gives users the ability to create bulk exports with data from consent receipts. |
Cookie manager, Privacy officer, Consent manager, Cookie consultant |
The permissions can be configured with custom roles. |
|
Create bulk exports for data subjects |
Gives users the ability to create bulk exports with data from data subjects. |
||
|
Download consent receipts export files |
Gives users the ability to download export files for consent receipts. |
||
|
Download data subjects export files |
Gives users the ability to download export files for data subjects. |
||
|
View bulk exports |
Gives users the ability to view the list of bulk exports. |
||
|
Cancel bulk exports |
Gives users the ability to cancel or delete pending or scheduled exports. |
Example JSON Exports
- Data subjects
-
JSON
{"key":"019e333f-a29f-8e88-91e1-1e2b64cade99","otJwtVersion":"1","dataSubjectIdentifierHash":"688f16d912ddddf57c6cbd3f4542ae5c15344380abbc7da048024658c75c04e425257dcd92a4432033bff0ce99a8dc5d896e8e4cc12cbe8a79d939b32916a081","dataSubjectIdentifier":"Colten.Kohler555@yahoo.com","collectionPointUUID":"0b0bb158-2a78-496a-914f-c929d45ee59f","collectionPointVersion":2,"consentCreationDate":"2026-05-17T00:04:28.959Z","receiptJwt":"","customPayload":null,"test":false,"origin":"ONETRUST","doubleOptIn":false,"language":null,"interactionDate":"2026-05-17T00:04:28.975Z","isAnonymous":false,"collectionPointType":"API","dsDataElements":null,"attributes":null,"unsubscribe":false,"source":null,"dsAttachments":"[]","additionalIdentifiers":"{}","geolocation":null,"dsPurposes":[{"id":"7f88992a-2ea4-4e4e-b696-4d4b94a70c21","name":"Purpose1_520508890276","transactionId":"63430daf-2299-5f27-a097-4823dc6af3c8","version":1,"transactionType":"NOTGIVEN","customPreferences":null,"preferences":[],"previousTransactionStatus":null,"expiryDate":null,"purposeNote":null,"attributes":{},"autoGenerated":"false","privacyNotices":[],"purposeAttachments":[],"consentInteractionDate":"2026-05-17"},{"id":"25e1b100-3c4f-4812-8b25-ab42dc5b483f","name":"Purpose1_1039162","transactionId":"636ea938-a584-5097-82a9-75604bc3c9ea","version":1,"transactionType":"NOTGIVEN","customPreferences":null,"preferences":[],"previousTransactionStatus":null,"expiryDate":null,"purposeNote":null,"attributes":{},"autoGenerated":"false","privacyNotices":[],"purposeAttachments":[],"consentInteractionDate":"2026-05-17"}]}
Export details screen reference
- Field
- Description
- Export name
-
Enter a name for the export.
- File type
-
Select the file type you want the export to download as. You can select JSON or CSV.
- Data type
-
Select the data type for the export.
-
Data subject profiles: Export groups of data subjects based on specific parameters.
-
Consent receipts: Export interaction data from interfaces, like collection points or preference centers.
-
- Date filter
-
Select the date type by which you want to filter the export.
-
Created date
Note:Consent receipt exports can only be configured with the Created date filter.
-
Last modified date
-
Last interaction date
-
- Start date and end date
-
Select a start and end date for your export's date range.
Filters and parameters screen reference
Use this screen to filter and refine your export for enhanced specificity.
Data subject profiles
- Field
- Description
- Primary identifier type
-
Select the primary identifiers for the data subject profiles.
- Additional identifier type
-
Select additional identifiers for the data subject profiles.
- Purposes
-
Select the relevant purposes.
- Purpose preference and value
-
Select a purpose preference and associated value.
- Purpose status
-
Select purposes statuses.
- Withdrawal notes
-
Select a withdrawal note.
- Collection points
-
Select the relevant collection points.
- Data element and value
-
Select a data element and its associated value.
Consent receipts
- Field
- Description
- Purpose
-
Select the relevant purposes.
- Version
-
Select the purpose versions.
- Collection points
-
Select the relevant collection points.
- Version
-
Select the collection point versions.
- Collection point type
- Select the collection point types.
To create a bulk export integration event
To filter Bulk Export Integration Events
You can customize filters by adding a condition based on the export type according to your needs.
Available Bulk Export Integration Events
The following integration events are available in Reports.
|
Integration Event |
Description |
|---|---|
|
Bulk Export Completed |
This trigger generates an event each time a bulk export is finished. The following bulk export types are available:
|
Bulk Export Events Sample Payloads
The following sample payloads show the data that is sent for each of the available bulk export integration events.
Bulk Export Completed
{
"runId": <RUN_ID>
"status": "SUCCESS" // Could be SUCCESS or FAILED
"exportType": "DATA_SUBJECTS" // Could also be CONSENT_RECEIPT or COOKIE_RECEIPT
"files": [
{
"reference": "af8ed1cf-33ea-4bb8-ab49-0e572cc02823",
"fileName": "af8ed1cf-33ea-4bb8-ab49-0e572cc02823.csv.gz"
"fileSize": 2000,
"fileType": "csv",
"file": "af8ed1cf-33ea-4bb8-ab49-0e572cc02823:2000:csv:af8ed1cf-33ea-4bb8-ab49-0e572cc02823.csv.gz"
},
{
"reference": "90f2241a-16d7-45e8-b913-1cb9951bb843",
"fileName": "72e2a55b-a271-4469-aeb0-cee19d1f37d7.csv.gz"
"fileSize": 2000,
"fileType": "csv",
"file": "90f2241a-16d7-45e8-b913-1cb9951bb843:2000:csv:72e2a55b-a271-4469-aeb0-cee19d1f37d7.csv.gz"
}
<ETC...>
]}
}
Filter and call the Bulk Export APIs to retrieve consent records from OneTrust. For more information, see Bulk Export APIs and the Bulk Export for Data Subjects, Consent Receipts, and Cookie Receipts recipe in the Developer Portal.