(Beta) Braze connection


The Braze destination in Adobe Experience Platform is currently in Beta. The documentation and the functionality are subject to change.

The Braze destination helps you send profile data to Braze.

Braze is a comprehensive customer engagement platform that powers relevant and memorable experiences between customers and the brands they love.

To send profile data to Braze, you must first connect to the destination.

Destination specs

Note the following details that are specific to the Braze destination:

  • You can send any identity to the Braze destination, as long as you map it to the Braze external_id.
  • Adobe Experience Platform segments are exported to Braze under the AdobeExperiencePlatformSegments attribute.

Keep in mind that sending additional custom attributes to Braze may cause increases in your Braze data point consumption. Please consult with your Braze account manager before sending additional custom attributes.

Use cases

As a marketer, I want to target users in a mobile engagement destination, with segments built in Adobe Experience Platform. Additionally, I want to deliver personalized experiences to them, based on attributes from their Adobe Experience Platform profiles, as soon as segments and profiles are updated in Adobe Experience Platform.

Export type

Profile-based - you are exporting all members of a segment, together with the desired schema fields (for example: email address, phone number, last name) and/or identities, according to your field mapping.
Adobe Experience Platform segments are exported to Braze under the AdobeExperiencePlatformSegments attribute.

Connect to destination

In Connections > Destinations, select Braze, and select Configure.

Configure Braze Destination


If a connection with this destination already exists, you can see an Activate button on the destination card. For more information about the difference between Activate and Configure, refer to the Catalog section of the destination workspace documentation.

Activate Braze Destination

In the Account step, you need to provide your Braze account token. This is your Braze API key. You can find detailed instructions on how to obtain your API key here: REST API Key Overview. Enter the token and click Connect to destination.

Braze Destination Account Step

Click Next. In the Authentication step, you need to enter the Braze connection details:

  • Name: enter a name by which you will recognize this destination in the future.
  • Description: enter a description that will help you identify this destination in the future.
  • Endpoint Instance: ask your Braze representative which endpoint instance you should use.
  • Marketing action: marketing actions indicate the intent for which data will be exported to the destination. You can select from Adobe-defined marketing actions or you can create your own marketing action. For more information about marketing actions, see the Data Governance in Adobe Experience Platform page. For information about the individual Adobe-defined marketing actions, see the Data usage policies overview.

Braze Authentication Step

Click Create destination. Your destination is now created. You can click Save & Exit if you want to activate segments later, or you can select Next to continue the workflow and select segments to activate. In either case, see the next section, Activate Segments, for the rest of the workflow.

Activate segments

See Activate profiles and segments to a destination for information about the segment activation workflow.

Field mapping

To correctly send your audience data from Adobe Experience Platform to the Braze destination, you need to go through the field mapping step.

Mapping consists of creating a link between your Experience Data Model (XDM) schema fields in your Platform account, and their corresponding equivalents from the target destination.

To correctly map your XDM fields to the Braze destination fields, follow these steps:

In the Mapping step, click Add new mapping.

Braze Destination Add Mapping

In the Source Field section, click the arrow button next to the empty field.

Braze Destination Source Mapping

In the Select source field window, you can choose between two categories of XDM fields:

  • Select attributes: use this option to map a specific field from your XDM schema to a Braze attribute.

Braze Destination Mapping Source Attribute

  • Select identity namespace: Use this option to map a Platform identity namespace to a Braze namespace.

Braze Destination Mapping Source Namespace

Choose your source field, then click Select.

In the Target Field section, click the mapping icon to the right of the field.

Braze Destination Target Mapping

In the Select target field window, you can choose between three categories of target fields:

  • Select attributes: Use this option to map your XDM attributes to standard Braze attributes.
  • Select identity namespace: Use this option to map Platform identity namespaces to Braze identity namespaces.
  • Select custom attributes: Use this option to map XDM attributes to custom Braze attributes that you defined in your Braze account.
  • You can also use this option to rename existing XDM attributes into Braze. For instance, mapping a lastName XDM attribute to a custom Last_Name attribute in Braze, will create the Last_Name attribute in Braze, if it doesn’t already exist, and map the lastName XDM attribute to it.

Braze Destination Target Mapping Fields

Choose your target field, then click Select.

You should now see your field mapping in the list.

Braze Destination Mapping Complete

To add more mappings, repeat the previous steps.


Let’s say your XDM profile schema and your Braze instance contain the following attributes and identities:

XDM Profile Schema Braze Instance
  • person.name.firstName
  • person.name.lastName
  • mobilePhone.number
  • FirstName
  • LastName
  • PhoneNumber
  • Email
  • Google Ad ID (GAID)
  • Apple ID For Advertisers (IDFA)
  • external_id

The correct mapping would look like this:

Braze Destination Mapping Example

Exported data

To verify if data has been exported successfully to the Braze destination, check your Braze account. Adobe Experience Platform segments are exported to Braze under the AdobeExperiencePlatformSegments attribute.

Data usage and governance

All Adobe Experience Platform destinations are compliant with data usage policies when handling your data. For detailed information on how Adobe Experience Platform enforces data governance, see Data Governance overview.

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free