Forwarding Data Subject Requests

You can create an output to Braze that forwards data subject requests for erasure.

Before you configure Braze to forward data subject requests, be aware of the following:

  • To avoid profile resolution complexities and subsequent conflation of user data deletion downstream, only a single user profile is resolved. All other identities associated with the resolved user profile are included in the user deletion message sent to downstream partners.
  • When using the API or user interface, only a single identity of the same identity type is allowed when DSR for erasure forwarding has been enabled, such as a single customer ID, email address, or IDFA. You can send in multiple identities of different types such as Customer ID and email address. See API error messages for ID validation rules.
  • To forward DSR for erasure for multiple user profiles, send one erasure request per user profile.
  • mParticle forwards erasure requests on receipt of the request. The general processing time specified in General Request Workflow only applies to the mParticle fulfillment processing and does not apply to DSR for erasure forwarding.
  • Once forwarded, mParticle can’t guarantee that data is deleted by the partner. You can confirm with the partner that the request has been fulfilled.

To forward data subject requests to Braze, use the following process.

Step 1: Obtain Braze Access Credentials

Obtain your app’s API key and confirm the Braze instance it is running in.

If you can’t find the information, contact your Braze account representative.

Step 2: Create and Activate a DSR Output

Create a DSR forwarding configuration for Braze and activate it:

  1. From your mParticle workspace, open Setup > Outputs and select the Data Subject Requests tab.
  2. Click Add Data Subject Request.
  3. Choose Braze.
  4. In the Data Subject Request dialog:

    a. Enter a DSR output Configuration Name.

    b. Enter the API key you obtained in Step 1.

    c. Enter the External Identity Type, the mParticle User Identity type to forward as an External Id to Braze. You should generally use same User Identity type you used to set up your Braze event output configuration.

    d. Select the Braze Instance you obtained in Step 1.

  5. Save the configuration with the default Inactive or, if you are ready, set Forwarding Status to Active. Once the status has been set to Active, erasure requests are forwarded to Braze once an hour or every 1000 messages, with a max of 50 messages in each upload.
  6. Select I understand after reading the disclaimer.

Step 3: Submit Requests for Erasure

After the DSR forwarding is configured, use either the mParticle user interface or API to submit requests for erasure.

Step 4: Check Forwarding Status

You can check the forwarding request status in the mParticle UI or using v3 of the mParticle DSR API.

Check Status With UI

To check status, visit Privacy > Data Subject Requests.

To see more detail, click the request ID.

Check Status With API

To check forwarding status per partner, use the GET /requests/{RequestID} resource. The status reported is for forwarding and does not indicate fulfillment status from the partner.

See Data Subject Request API for information about API callbacks and the extensions element that supports erasure.

Step 5: Verify Partner Fulfillment

Once forwarded, mParticle cannot guarantee that data is deleted from your outputs. Always confirm that each partner fulfills the request.

Was this page helpful?