Integrating mParticle

Capabilities

DataGrail's mParticle integration provides the following capabilities:

Product	Capability
Request Manager	Request Types Access, Deletion, Do Not Sell/Share Identifier Categories Email

Before You Start

To successfully configure this integration, please ensure you have sufficient privileges:

• DataGrail User Role: Super Admin, Connections Manager
• mParticle User Role: Admin

Get mParticle API Credentials

1. Log in to mParticle.
2. In the top left corner, select the Workspace and then Settings.
3. Select the Workspace to edit.
4. Enable data privacy controls.
5. Navigate back to Workspace Settings and select the Workspace to edit.
6. Copy the Workspace Key and Workspace Secret. Store them in a secure, temporary location.
7. In the left side menu under Setup, select Inputs.
8. For Web platform, select Configure.
9. Select Issue Keys.
10. Copy the Web Key and Web Secret. Store them in a secure, temporary location.

Connect to DataGrail

1. In DataGrail, navigate to Integrations and select Configure New Integration to search for mParticle.
2. Enter the Workspace Key, Workspace Secret, Web Key, and Web Secret.
3. Select the POD (data center) that your mParticle account uses for data localization.
4. Select your desired Asynchronous Deletion Behavior.

mParticle Deletion Behavior Configuration

Mark integration as complete when a deletion request is successfully submitted: The mParticle Integration will be marked as "complete" as soon as the deletion request is submitted to mParticle.

Continue processing until the deletion request is completed (default behavior): The mParticle Integration will show a "processing" status until the mParticle deletion is complete.

5. Select Configure Integration.

Next Steps

Now that you've successfully connected the integration, check out the following resources:

• Synchronous vs. Asynchronous Integrations
• Whole Record Deletion
• Access Request Lifecycle
• Deletion Request Lifecycle

Troubleshooting

If you are unable to successfully connect the integration, review these common troubleshooting steps:

Ensure Required Permissions Are Granted on API Keys/Resources

DataGrail checks required permissions and scopes on API keys/resources used by each integration. If all necessary permissions are not granted, new connections will fail.

Review Required Account Types and User Roles

If users do not have the necessary permissions or the minimum required user role in the connecting system, the connection to DataGrail will fail. Additionally, connections will fail if your account type does not match the one required by the integration.

See Before You Start to review these requirements.

Technical Details

The mParticle integration uses the Identity v1, Events v2 and Data Subject Request v3 APIs:

Access Type	Asynchronous
Deletion Type	Asynchronous (Whole Record)

API Documentation

Learn more about this API implementation and DataGrail functionality in our API Integration Documentation.