---
title: Integrate Braze
slug: data-platform/docs/integrate-braze
docTags: 
createdAt: 2026-08-10T12:05:15.000Z
---

:::hint{type="info"}
**Note**

The terms *audiences* and *segments* are interchangeable. Optimizely has updated all *segments* to *audiences* on the **Audiences** page and is updating the UI on other pages. See  [Understand audiences](docId\:v-gHiL9jfINBey-4QNtFM) to get information on audiences.
:::

Sync your Braze customer segments and events to Optimizely Data Platform (ODP) nightly to enrich customer profiles, reports, and segmentation.

You can also sync ODP customer data and events to Braze to enrich your Braze customer data and trigger Braze messaging based on customer events in ODP (like opening an email).

## Prerequisites

- Braze account
- ODP account

## Update API app consent setting

You only need to complete the instructions in this section if your app consent setting for the API channel is set to **Opted Out**. This setting must be set to **Opted In** for this app to successfully send data.

1. Go to **Settings > App Consent Settings** in ODP.
2. Set the **Api** app's **Default Consent** to **Opted In**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ReEqOwz9ep8rHhK3HVmLw_odp-app-consent-setting.png" size="90" width="1054" height="909" isUploading="false" darkWidth="1054" darkHeight="909" showCaption="false"}

3. Click **Update Consent** in the confirmation prompt.

## Enable the integration

1. Go to **Data Setup > App Directory** in ODP.
2. Select the **Braze** app.
3. Click **Install App**.
4. Enter your Braze **REST API Key**, select your Braze **Instance URL**, and click **Verify API Key** on the **Settings** tab.
5. Create a Custom Currents Export in Braze using the endpoint and token provided in ODP. This is required to sync Braze events to ODP.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/k41Qw2DYmKJAD0p6x9Gj7-20260720-145645.png" size="90" isUploading="false" width="842" height="535" darkWidth="842" darkHeight="535" showCaption="false"}

6. Expand the **Segments** section of the Braze app in ODP.
7. Select the Braze audiences you want to sync to ODP from the **Segments to Sync** multi-select list.

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/EprsFVCEzdIUn1Old9ga5-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="883" height="500" darkWidth="883" darkHeight="500"}

:::Paragraph{indent="1"}
If you want to sync all segments, select **Import All User Profiles**.
:::

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/29Y2CE_cWsQ2i4rKTao26-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="838" height="155" darkWidth="838" darkHeight="155" indent="2"}

:::hint{type="warning" indent="2"}
**Important**

You must select audiences here (or opt to import all audiences) to import Braze customer profiles. If you do not select any audience, the integration will not import any customer profiles.
:::

8. [Add any additional field mappings](docId\:uz6s8Mdfz_O22DSbAQZsA) you want between Braze and ODP in the **Segments** section.
9. Click **Save** to start syncing data from Braze to ODP.

### Map data fields

The app has default data field mappings between Braze and ODP. For example, the *Email* field in Braze is mapped to the *Last Seen Email* field in ODP.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/4MFnOnq_sVySkgoZlARCw-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="973" height="961" darkWidth="973" darkHeight="961" indent="2"}

If there are additional data fields in Braze that you want to map to ODP, complete the following in the **Segments** section of the app:

1. Select the Braze field from the **Braze User Data Fields** drop-down list.
2. Select the ODP field from the **ODP Customer Fields** drop-down list.
3. Click **Save Field Map**.

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/CkIxZnNDb5t0Q1WYwd0vi-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="849" height="236" darkWidth="849" darkHeight="236"}

You can also delete any data field mappings that are not required in the **Segments** section of the app:

1. Select the field mapping you want to delete from the **Field Map** drop-down list.
2. Click **Delete Field Map**.

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/pMmZL3Rsz3r_URQuBTima-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="771" height="166" darkWidth="771" darkHeight="166"}

## Sync data from ODP to Braze

After you configure the app, you can set up an activation in ODP to sync your ODP customer data to Braze.

1. Go to **Activations > Overview**.
2. Click **Create New Campaign**.
3. To set up an automated, recurring sync, click **Behavioral**.
4. Click **Create From Scratch**.
5. Enter a name for your activation that represents the data you are syncing to Braze (for example, *Braze Data Sync*).

   ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/Szmt0qQY0ErduhHIwXn6X-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="1448" height="76" darkWidth="1448" darkHeight="76"}
6. Choose to sync data for customers that match a audience or sync data for customers that trigger an event (like when ODP registers that a customer opens an email) in the **Enrollment** section.
   - **Customers that match a segment** – Select your desired audience and click **Apply** or click **Create New Segment**, select your desired audience conditions, and click **Save**. Expand **Enrollment Rules** and adjust as desired.

     ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/HtIa4jojpMkCTFp0s3LVx-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="1153" height="714" darkWidth="1153" darkHeight="714"}
   - **Customers that trigger an event** – Expand the **Filter** drop-down list and select the ODP event that you want to use as the trigger for this data sync to Braze. Expand **Automation Rules** and adjust as desired.

     ::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/hGhJkqW3MXXPJ5YMUoyns-20260720-145645.png" size="100" isUploading="false" showCaption="false" width="1149" height="240" darkWidth="1149" darkHeight="240"}
7. Expand **Touchpoints**.
8. Click to edit **Touchpoint 1** and select **Braze**.
9. Expand the **Targeting** section and select the **Target Identifier**.
10. Select one of the following options for **Add Users To** in the **Configure** section:
    - **Campaign** – Add customers to a specific campaign in Braze. After choosing this option, you must select the Braze campaign.
    - **Canvas** – Add customers to a specific canvas in Braze. After choosing this option, you must select the Braze canvas.
    - **Profile Update Only** – Update only the Braze customer profile.
11. (Optional) Select the **Number of Additional Fields** you want to sync to Braze (up to 20).
    A drop-down list and input field display for the number of additional fields you selected. In each **Field #** drop-down list, select the Braze field you want to populate. In each corresponding **Field # Value**, enter the ODP field you want to send to the selected Braze field. For example, if you selected *Company Name* from the **Field #** drop-down list, enter  for the corresponding **Field # Value**.
12. Click **Save** and then click your activation name in the breadcrumb trail.
13. Click **Select start time and schedule** in the **Touchpoints** section if you selected **Customers that match a segment** for the enrollment.
14. . Complete the following settings, then click **Apply**.
    - **Recurring or Continuous** – Select **Recurring**.
    - **Start Date** – Enter the date you want to send the data to Braze.
    - **End** – Defaults to **Never**. If you want to end the Braze data sync on a specific date, set that here.
    - **Repeats** – Set to **Daily**.
    - **Repeat Every** – Set to **1 day**.
    - **Timing** – Enter the time you want to send the data to Braze.
    - **Time Zone** – Select the time zone in which you want to send this data.
15. Click **Save** and then click **Go Live**. Your sync starts at your designated start date and time (or when the trigger event occurs).

## Troubleshoot the data sync

To ensure data is syncing as expected between ODP and Braze:

1. Go to **Settings > Event Inspector** in ODP.
2. Click **Start Inspector**. A number displays next to **Refresh** when data is available in the inspector.
3. Click **Refresh** to view the data. The raw data that ODP and Braze send back and forth displays.
4. Click **View Details** to see the formatted version of that raw data. Data fields sent from Braze back to ODP start with `_braze`.

Each data sync is also logged in the [ODP activity log](docId\:iFvVHEUE8tk4PlyXWw4Ro):

1. Go to **Settings** > **Activity Log**.
2. Filter the categories by **braze**.
3. Click **View Details** for a formatted view of the log details, including the number of matches.