Connect this destination to export audience membership, send API-triggered email campaigns from journeys, or write warehouse rows onto Braze profiles, events, purchases, or subscription groups, for use in Braze campaigns and Canvas.

This destination writes to your Braze account and is a good fit when you want to:

• Target customers in Braze with GrowthLoop audiences
• Send a launched API-triggered email campaign from a GrowthLoop journey
• Sync a small set of personalization attributes, events, purchases, or subscription group states in Braze

This maps to GrowthLoop Audiences, Journeys, and Syncs:

For campaign and Canvas targeting patterns after an export, see Integrate with Braze.

Prerequisites

Make sure you have:

• A Braze account with permission to create a REST API key.
• A Braze REST API key. In Braze, go to Settings → APIs and Identifiers, click Create API Key, and name it something your team will recognize, such as GrowthLoop. Grant User Data, Purchases, and Events. If you will trigger email from journeys, also grant campaigns.list, campaigns.details, and campaigns.trigger.send. Copy the Identifier.
• Your Braze REST endpoint (API URL). In Braze, open Settings and find your SDK Endpoint. Then use the matching REST endpoint from Braze endpoint documentation. For example, if your dashboard is https://dashboard-03.braze.com, your API URL is https://rest.iad-03.braze.com.

📘

Note

You do not need to whitelist GrowthLoop IPs when you create the API key.

Set up Braze as a destination

1. In GrowthLoop, click the Destinations tab on the left sidebar.
2. Click New Destination in the top right corner.
3. Search for Braze and click Add Braze.

4. Enter the required information, then click Create.

GrowthLoop validates the credentials. Braze then appears in your list of connected destinations.

Export to Braze

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for Braze. In a journey, add a Destination Node under Email and select Braze.

To send audience membership only, keep the export action on Add to List Only if that option is shown. To send an API-triggered email campaign instead, see Send email from a journey.

Map contact identifiers

Map at least one identifier.

You can also map custom attributes from the audience or from the journey as additional fields.

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

Export behavior

This is what GrowthLoop writes when you export an audience.

Send email from a journey

You can send a Braze API-triggered email campaign from a journey Destination Node when campaign triggers are enabled for your organization. See Build a journey if you need more information on these steps.

1. Add a Destination Node and select your Braze destination.
2. Select Send Email as the export action.
3. Map Recipient's Email.
4. Choose the Braze campaign in Email Template. GrowthLoop lists API-triggered email campaigns, not content-library templates.
5. Map Template Variables that GrowthLoop loads from the campaign message.
6. Send a test email before you publish.

For GrowthLoop to expose template variables, the campaign must use Braze Liquid in this form:

{{api_trigger_properties.${first_name}}}

Send behavior

Create a sync in GrowthLoop

Create a sync from a warehouse table to write rows onto Braze profiles, events, purchases, or subscription groups. See Syncs for information on how to complete those steps.

Select an Object Type:

When you configure the sync:

• Connection: Select your Braze destination.
• Object Type: Select an object from the table above.
• Update Rule: For Event and Purchase, choose Insert. For Profile Attribute, choose Insert, Update, or Upsert. For Subscription Group Status, choose Update. See Sync behavior.
• Match Field: Map a stable identity such as external_id, email, or phone.

Only sync attributes you use often in message personalization. We recommend starting with at most 20 attributes.

Event fields

Purchase fields

Profile Attribute fields

Map at least one profile field, such as Country Code.

You can sync JSON objects and object arrays to Braze profile attributes. Store the warehouse value as a string. GrowthLoop converts that string to JSON during export.

In Braze, create the custom attribute first. Choose Object for a single JSON object, or Object Array for an array of JSON objects.

Example warehouse values:

• Single JSON object: '{"city":"Abilene","state":"Texas","zip_code":79605}'
• Array of JSON objects: '[{"city":"Abilene","state":"Texas"}, {"city":"Austin","state":"Texas"}]'

Object or object-array attributes created in Braze do not appear as selectable destination values. Enter the attribute name exactly as it appears in Braze, then map the source column. The name may appear as undefined in the dropdown. That does not block the sync.

Subscription Group Status fields

After you map fields, click Update Sync. Choose Updates Only the first time. Use Back-fill only when you add fields to an existing sync and need those fields on events already sent. Back-fill can be expensive in your data warehouse.

Enable the sync with the toggle at the top of the page.

Sync behavior

This is what GrowthLoop writes when you sync to Braze.

Confirm the export was successful

When the run finishes, confirm you can use the data in Braze.

• Audience export: In Segments, add a Custom Attributes filter and select the export name with is True.

• Journey Destination Node: In Segments, add a Custom Attributes filter and select the export name with is True. Look up a contact who reached the node.
• Send Email: Confirm Braze sent the selected API-triggered campaign.
• Event sync: Search for the contact in Braze Audience → Search Users and review Custom Events.

• Purchase sync: Search for the contact and review the purchase.
• Profile Attribute sync: Search for the contact and check the mapped attributes.
• Subscription Group Status sync: Confirm the subscription state on the mapped group.

In GrowthLoop, review counts on the audience Exports tab, open the Activity tab on the journey Destination Node, or confirm the sync appears in the Syncs table. See Export an audience, Monitor a journey, or Syncs for more information.

Congrats on successfully exporting to Braze!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.