Braze is a marketing automation platform for mobile apps, with user analytic, segmentation, push, and email marketing feature sets.

mParticle audiences correspond to Braze’s Segments feature and can be used to target engagement campaigns in Braze.


In order to activate our Braze integration, you’re going to need the API key for each app that you’d like to set up, which can be found by logging into your Braze account and navigating to your app’s settings. You will also need to create an App Group REST API Key in the Developer Console.

Data Center Location

Braze maintains several data clusters so, as part of the Configuration Settings, you need to specify which cluster your data should be forwarded to. Generally, older Braze customers are in the US 01 Cluster, while newer customers are in US 03 Cluster. You can tell your data cluster from the URL of your Braze Dashboard:

Cluster Dashboard URL
US 01 Cluster
US 02 Cluster
US 03 Cluster
EU 01 Cluster

Check with your Braze account manager if you are unsure which data cluster you are using.

User Identity Mapping

mParticle will attempt to match users in Braze based on IDFAs, Android Device IDs, and a customizable External User ID field, which uniquely identifies a user in Braze. You can set which Identity Type to use as the External User ID in the Configuration Settings. Your External User ID should be a unique, permanent identifier — usually Customer ID or Email. If you are also using the Event integration, make sure you set the same External User ID across both integrations.

Forwarding Audiences

The Braze API does not allow mParticle to directly create and maintain membership of segments in Braze, so the Audience integration works by setting attributes on a user, which you can then use to define a corresponding segment in Braze. Like mParticle, Braze populates it’s Segment Manager based on the actual data points received, so you need to create audiences in mParticle and connect them to Braze first. Then, provided your audience is not empty, the segment membership attributes should become available in the Braze Segment Manager within a few minutes.

mParticle offers two ways to set segment membership attributes, controlled by the Create One User Attribute per Segment option in the Configuration Settings.

If Create One User Attribute per Segment is false (default)

mParticle creates a single custom attribute in Braze for each user, called SegmentMembership. The value of this attribute is a list of mParticle audience IDs that match the user. Audience IDs can be found in the main Audience list view. For example, given these three audiences:

A user who is a member of both Aspiring Athenians and Ibiza Dreamers will show the attribute SegmentMembership = ['11036', '11034'] in Braze:

To target members of Ibiza Dreamers, you need to create a matching segment in Braze, with the filter SegmentMembershipmatches regex11034. It’s important to choose the matches regex option, and not equals, or users with membership in more than one audience will not be matched.

If Create One User Attribute per Segment is true

For each audience that matches a user, mParticle creates a custom attribute in Braze, based on the External Name of the audience. For example, a user who is a member of Possible Parisians will show the attribute In Possible Parisians = true in Braze:

To target members of Possible Parisians, you need to create a matching segment in Braze, with the filter In Possible Parisiansequalstrue.

Configuration Settings

Setting Name Data Type Default Value Description
API Key string Your app’s API Key can be found in your Braze dashboard.
Create One User Attribute per Segment bool False If enabled, mParticle will forward membership information for each audience as a separate user attribute. For example, if you’re forwarding an audience named “New Users”, mParticle will forward membership information for this audience in a user attribute called “In New Users”, with a value of “true” or “false”.

If disabled, mParticle will forward a single user attribute called “SegmentMembership”, and its value will be a comma-separated list of mParticle audience IDs that the user is a member of, wrapped in single quotes (e.g., “‘123’,‘456’,‘789’”).
App Group REST API Key string The App Group REST API Key can be found in the developer console section of the Braze dashboard.
Braze Instance enum United States Specify which cluster your Braze data will be forwarded to. Please ensure you are contractually authorized to use the EU cluster if you select that option. If you choose ‘Custom’, you will need to provide separate endpoints for your SDK, Server, and Web data.
External Identity Type enum Customer ID The mParticle User Identity type to forward as an External ID to Braze.

Was this page helpful?