Anonymize customers in-bulk

/data/v2/projects/{projectToken}/customers/anonymize_bulk

This method initiates anonymization of multiple customers.

The anonymization process removes all Private information and all external identifiers and assigns a new cookie ID.

Please note that apart from customer IDs, the anonymize call only removes properties that have been marked as Private - "Personal Identifiable Information" (PII). You need to manually specify which properties are Private in the Data manager within your Bloomreach Engagement project. Learn more about managing PII.

Definition

Authentication

In this API call you must use the following authorization access and permissions:

Available access typePermissions needed
Private accessGDPR > Anonymize customer

Read more about authentication and access keys in the API groups section.

Path parameters

ParameterTypeDescriptionRequired
projectTokenstringThe ID of your project.Required

Body parameters

ParameterTypeDescriptionRequired
customersarray of objectsList of customer identifiers to be anonymized. You can do that in 2 ways:

(1) By an external customer ID, such as registered;

(2) By the Bloomreach Engagement internal ID, which can be found in the URL of a customer. Open the customer in Data & Assets -> Customers. The ID is a hash from last part of URL. Alternatively internal ID can be found also in the Bloomreach Engagement BigQuery customer tables.

See the formats below.

Max 1000 customers.
At least 1 required.

Customers available formats

ParameterFormat
External ID, in this example: registered{"customer_ids": {"registered": "[email protected]"}}
Bloomreach Engagement internal ID{"internal_id": "57e99c7bfb60099395b94b6d"}

Headers

ParameterTypeDescriptionRequired
authorizationstringUsed for authentication. Read more in the Authentication section.Required
content-typestringapplication/jsonRequired

Additional payload example

{"customers": [
  {"customer_ids": {"registered": "[email protected]"}},
  {"customer_ids": {"registered": "[email protected]"}},
  {"internal_id": "57e99c7bfb60099395b94b6d"}
]}

Limitations

You can target a maximum of 1000 customers in a single bulk request.

Language
Authorization
Basic
base64
:
Click Try It! to start a request and see the response here!