> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Braze Cohorts

> Build better campaigns on Braze with up-to-date customer data from your data warehouse

This destination is specific to the [Braze Cohort Import](https://www.braze.com/docs/partners/data_and_analytics/reverse_etl/hightouch/hightouch_cohort_import) feature, which lets partners like Hightouch manage user cohorts within Braze automatically. The Braze Cohorts feature is an excellent alternative to storing audience subscriptions into user-level attributes in Braze since it can reduce your Braze [data point](https://www.braze.com/docs/user_guide/onboarding_with_braze/data_points/) consumption when segmenting audiences.

### Get Braze data import key

In Braze, navigate to **Technology Partners** and select **Hightouch**. Here, you will find your REST Endpoint and generate your Braze data import key. Once generated, you can create a new key or invalidate an existing one.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-braze-cohorts-data-import-key.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=eebab2dd37b338fe8ae1a53f929330e0)

### Add Braze Cohorts as a destination in Hightouch

Navigate to the **Destination** page in your Hightouch workspace, search for **Braze Cohorts**, and click **Continue**. From there, take your REST endpoint and data import key and click **Continue**.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-braze-cohorts-create-braze-cohort-destination.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=6ab088f71a1dee1ec2f89b792a5260be)

### Sync a model or audience into Braze Cohorts

In Hightouch, using your created [model](https://docs.hightouch.com/syncs/create-your-first-sync.md#set-up-a-model) or [audience](https://docs.hightouch.com/customer-studio/usage.md), create a new sync. Next, select the Braze Cohorts destination you created in the previous step. Lastly, in the Braze Cohorts destination configuration, select the identifier you want to match against and decide whether or not you want Hightouch to create a new Braze Cohort or update an existing one.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-braze-cohorts-record-matching.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=67a537304d36566e7e88cfa861f24c04)

#### Sync behavior

Braze Cohorts supports an **Add, Remove** sync pattern:

* **Add**: Adds users present in your model or audience to the selected Braze Cohort.
* **Remove**: Removes users who are no longer present in your model or audience from the Braze Cohort. When Hightouch detects via [CDC](https://docs.hightouch.com/syncs/cdc.md) that a user has dropped out of the model or audience, it sends a remove operation for that user so they are taken out of the Braze Cohort on the next sync run. This only removes them from the cohort--it does **not** delete the underlying Braze user profile.

Hightouch handles these changes automatically on each sync run so your Braze Cohort always reflects the current membership of your model or audience.

### Create and use a Braze Segment from the Hightouch custom audience

In Braze, navigate to **Segments**, create a new segment, and select **Hightouch Cohorts** as your filter. From here, you can choose which Hightouch cohort you wish to include. Once created, you can select your Hightouch cohort segment as an audience filter when creating a campaign or Canvas.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-braze-cohorts-create-braze-segment.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=cb3e52e3666a8cf36f00802d6c6442de)

To use your Hightouch segment, create a Braze campaign or Canvas and select the segment as your target audience.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-braze-cohorts-hightouch-segment.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=73a5b92bf26f5d4826891d259215c620)

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).
