Braze Cohorts Destination

On this page

Destination Info

Braze is an engagement platform that empowers growth by helping marketing teams build customer loyalty through omni-channel customer experiences. The Braze Cohort API is a multi-channel marketing interface that allows you to import cohorts of users into Braze. These cohorts can be used to build better campaigns with the most accurate customer data.

Segment’s Braze Cohorts destination syncs Engage audiences to Braze as cohorts. This is a more scalable alternative to storing audience subscription in user-level attributes in Braze. It also is more efficient as audiences are uploaded as a list, as opposed to individual events.

The Braze Cohorts destination is in beta and is in active development. Some functionality may change before it becomes generally available.

Getting started

Before connecting to the Braze Cohorts destination, you must have a Braze account and an Ad Account ID.

To connect the Braze Cohorts destination:

  1. From the Segment web app, navigate to Engage > Audiences. Ensure you are in the Engage space you plan to use with the Braze Cohorts destination. Either choose an existing Engage Audience or create a new one. This is the Audience you plan to send to Braze as a cohort.

  2. Within the Audience, click Settings and copy the Audience Key. You’ll need this key later.

  3. Navigate to Engage > Engage Settings and click Destinations. Please ensure you are still in the correct Engage space.

  4. Search for “Braze Cohorts” and select the destination.

  5. Click Configure Braze Cohorts.

  6. On the Select Source screen, your Engage space should already be selected as the source. Click Confirm Source.

  7. On the Destination Settings tab, name your destination and authenticate with Braze Cohorts using OAuth.

  8. Once authenticated, input your Client Secret key from your Braze Dashboard account. Toggle “Enable Destination” on and click Save Changes.

  9. Navigate to the Mappings tab, click New Mapping, and select Sync Audience.

  10. Under Select mappings, input the Audience Key you copied in Step 2 as the “Segment Engage Audience Key.” Do not change any other defaults. Click Save and toggle to enable the mapping.
    • Note: Users can be added or removed from cohorts through ExternalId, DeviceId, or the UserAlias object. The priority is ExternalId, then DeviceId, and finally UserAlias if all are provided.
    • The Audience Key must be manually entered to ensure users in the Engage Audience are sent to the correct cohort in Braze. For every Engage Audience you want to send to Braze, a separate Sync Audience mapping must be created. You can create up to 50 mappings within an instance of the Braze Cohorts destination.
  11. Navigate back to Engage > Audiences and click on the Audience from Step 1.

  12. Click Add Destinations and select the Braze Cohorts destination you just created. In the settings that appear in the side panel, toggle the Send Track option on and do not change the Audience Entered/Audience Exited event names. Click Save Settings.

The setup is complete and the Audience will start syncing to Braze Cohorts. Segment will create a new cohort (if one does not already exist for the given Audience Key) and add/remove users to/from the cohort accordingly. The Audience appears in your Braze account, account under Engagement > Segments.

To sync additional Audiences from your Engage space, create a separate mapping in the Braze Cohorts destination. Navigate to Connections > Destinations, search and select the Braze Cohorts destination, and follow Steps 9-11 above.

A user can only be added to a cohort if the user already exists in Braze. This means that the Braze Cohorts destination should be used in parallel with the Braze Cloud Mode (Actions) destination or the Braze Web Mode (Actions) destination, both of which can create users in Braze.

Destination Settings

Setting Description
Client Secret key Required.

Data Import Key for the client whose cohort this belongs to. Also known as customer key.

REST Endpoint Required.

Your Braze REST endpoint. See more details

Available Actions

Build your own Mappings! Combine supported triggers with the following Braze Cohorts-supported actions:

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Sync Audience

Record custom events in Braze

Sync Audience is a Cloud action. The default Trigger is: event = "Audience Entered" or event = "Audience Exited"

Click to show / hide fields

Field Description
External User ID Type: STRING

The external_id serves as a unique user identifier for whom you are submitting data. This identifier should be the same as the one you set in the Braze SDK in order to avoid creating multiple profiles for the same user.

User Alias Object Type: OBJECT

Alternate unique user identifier, this is required if External User ID or Device ID is not set. Refer Braze Documentation for more details.

Device ID Type: STRING

Device IDs can be used to add and remove only anonymous users to/from a cohort. However, users with an assigned User ID cannot use Device ID to sync to a cohort.

Cohort ID* Type: HIDDEN

The Cohort Identifier

Cohort Name* Type: HIDDEN

The name of Cohort

Enable Batching Type: BOOLEAN

Enable batching of requests to the Braze cohorts.

Segment Engage Audience Key* Type: STRING

The audience_key of the Engage audience you want to sync to Braze Cohorts. This value must be a hard-coded string variable, e.g. personas_test_audience, in order for batching to work properly.

Event Properties* Type: OBJECT

Displays properties of the event to add/remove users to a cohort and the traits of the specific user

Time* Type: HIDDEN

When the event occurred.

This page was last modified: 07 Mar 2023

Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
Create free account