Skip to content


BlueConic, the leading pure-play customer data platform, liberates companies’ first-party data from disparate systems and makes it accessible wherever and whenever it is required to transform customer relationships and drive business growth.

The Braze and BlueConic integration allows users to unify data across persistent, individual profiles and then sync it across the two systems for import goals via an Amazon Web Services S3 server. Potential goals include growth-focused initiatives, customer lifecycle orchestration, modeling and analytics, digital products and experiences, audience-based monetization, and more. This integration supports both scheduled batch import and export.


Requirement Description
BlueConic account A BlueConic account is required to take advantage of this partnership. You will need access to view and edit connections within your BlueConic account to access the plugins.
Braze REST API key A Braze REST API key with users.track, users.export.segment, campaigns.list, campaigns.details, segments.lists, and segments.details permissions.

This can be created in the Braze dashboard from Settings > API Keys.
Braze REST endpoint Your REST endpoint URL. Your endpoint will depend on the Braze URL for your instance.
S3 authentication You will need access to an Amazon Web Services (S3) server to export and import the data.
Access key ID
Secret access key
The access key ID and secret access key will allow you to authenticate your S3 server for importing and exporting.
AWS bucket You will need to connect to S3 within the plugin. After authentication, the available buckets will show in a dropdown menu. This is where files to be imported or exported are stored.


Step 1: Creating a Braze connection

In BlueConic, select Connections in the navigation bar, and then Add Connection. In the prompt that appears, search Braze and select Braze connection.

Expand or collapse available metadata fields in the connection by clicking the gray chevron icon. Within these fields, you can favorite this connection, name your connection, add labels, include a description, and choose to get email notifications if the connection runs or fails to run.

Save your settings.

Step 2: Configuring a Braze connection

To configure the connection between BlueConic and Braze, you must add your Braze account credentials and Amazon Web Services (S3) account information to authenticate the connection.

  1. In BlueConic, select Set up and run in the Setup section in the left panel.

  2. In the Braze authentication page that opens, enter your Braze REST API endpoint and Braze API key.

  3. In the S3 setup and authentication section, enter the Amazon Web Services (S3) access key ID, secret access key, and S3 bucket. Save your settings.

Step 3: Creating import or export goals (import mapping)

Once the authentication is complete, you must create at least one import or export goal, turn the connection on, and schedule or run the connection.

  1. Select Import data into BlueConic in the left panel to open the Braze data configuration page.

  2. Select the location of the data in Braze. Here, you can tell BlueConic where to find the data to be imported by selecting your Braze audience.
    The BlueConic Braze audience set as "BlueConic Test Users".

  3. Next, map identifiers between Braze and BlueConic.
    The Braze field "External ID" set to map to the BlueConic "Braze external ID" field.

    To link the customer data between the two systems, enter one or more customer identifiers.
    Use the Allow creation… checkbox to allow BlueConic to create new profiles for data that does not match an existing BlueConic profile.

  4. Next, match the BlueConic data fields you are exporting to Braze fields. Use the dropdown fields to select either the BlueConic profile identifier or a profile property on the left and select the corresponding Braze profile identifier. Next, use the dropdown menu to specify how imported content should be added to existing values: added, summed, set only if the profile property is empty, or set to clear (if the Braze field is empty).

    Use the Add Mapping button to create additional mapping rows as needed. You can add multiple mapping rows with the Add remaining fields option. BlueConic detects the remaining Braze fields and matches them with BlueConic profile properties. You can set the merge strategy for imports (set, add, sum, set if empty or clear) and provide a custom prefix to the names of BlueConic profile properties.

  5. Lastly, select Run the connection to start the connection. Visit BlueConic to learn more about scheduling and running connections.
  1. Select Export data to Braze in the left panel to configure your data export from BlueConic to Braze.

  2. Choose a BlueConic segment for the export. Only profiles in this segment with matching identifiers in Braze will be exported.
    A BlueConic segment of 20k profiles.

  3. Next, link identifiers between BlueConic profiles and Braze fields. You can optionally choose to let BlueConic create new records if no existing match is found.
    The Braze field "External ID" set to map to the BlueConic "Braze external ID" field.

  4. Next, match the BlueConic data fields you are exporting to Braze fields. Use the dropdown menu from the BlueConic icon to choose the type of information you want to export. Available information includes profile properties, BlueConic profile identifiers, associated segments, all viewed interactions, permission levels, and a static text value.

  5. Lastly, click Run the connection to start the connection. Visit BlueConic to learn more about scheduling and running connections.

Step 4: Toggle connection on

Use the toggle next to the Braze connection title to toggle the connection on and off. A connection must be on to run during scheduled times.

New Stuff!