Consumer Data Privacy API
This document assumes that the reader has already created an API user and is capable of obtaining a token via the Monetate Auth API's /refresh endpoint. If you're unfamiliar with these steps, refer to Manage API Keys.
Various privacy policies and regulations require companies to delete customer data upon request. To help comply with these regulations, Monetate provides an API endpoint that accepts a list of customer IDs that should be deleted from its database. After deleting a customer ID, Monetate continues to purge that ID from its system if it is recognized in any future sessions.
To start, you must create a new dataset using a schema type called customer_data_privacy. This is a one-time configuration that defines a two-column dataset of customer_id and delete_request_time.
Use the Create a New Schema endpoint. Fields don't have to be defined because the schema type does this by default.
The schema creation process allows you to supply extra columns beyond the two required attributes. However, these fields aren't used in any capacity.
Once you create a customer_data_privacy dataset, you can begin sending customer IDs to Monetate through the dataset. Doing so triggers a process to delete those IDs from Monetate's database. You must provide two attributes in the request:
- customer_id — The unique identifier for the customer to be removed
- delete_request_time — The timestamp for when the customer's removal request was received in the ISO 8601 standard format (YYYY-MM-DD)
Use the Send Data endpoint.
If you created the dataset with extra columns, they can be passed with the rest of the data, but this data is ignored.
Monetate processes deletion requests through a series of nightly batch jobs. Requests typically take 24 to 48 hours to complete. After completion, the customer IDs no longer are in Monetate's system.
To confirm that a customer ID has been deleted, you can query the Customer ID Status endpoint.
The required customer_id is the customer ID for which you're submitting the status query.
The token can be the same one used in the endpoints above. Any valid API token works if you want to use different API users for different systems.
- PENDING — The customer_id has been found within Monetate's data stores and is pending removal.
- FOUND — The customer_id has been found within Monetate's data stores.
- NOT_FOUND — The customer_id has not been found within Monetate's data stores.
The NOT_FOUND status is expected once the customer_id has been completely removed from Monetate's data stores.
- 401 UNAUTHORIZED
- 403 FORBIDDEN
- 404 NOT FOUND
- 500 SERVER ERROR