Skip to main content

​
Overview

Our integration with Braze enables brands to deliver real-time retail purchase data as custom events, powering personalized messaging campaigns and customer journeys. This integration makes it easy to:
  • Trigger campaigns and Canvases based on verified retail purchases
  • Engage customers when they link or unlink retail accounts
  • Re-engage customers when their credentials expire with reconnection prompts
Connect your Braze account to get started.

​
Prerequisites

You’ll need a Braze REST API key with the users.track permission.
1

Create a REST API key in Braze

In your Braze dashboard, navigate to Settings > APIs and Identifiers. Click Create New API Key, give it a descriptive name (e.g. “Subtotal Integration”), and enable the users.track permission under the User Data section.
2

Find your Braze instance

Your Braze instance determines the regional API endpoint. You can identify it from your Braze dashboard URL. For example, if your dashboard URL is dashboard-01.braze.com, your instance is US-01.

​
Connect your Braze account

Sign in to the Subtotal Dashboard and connect your Braze account to enable the integration.
1

Navigate to Braze integration

Go to Integrations > Braze > Connect in the Subtotal Dashboard.
2

Enter your API key

Paste the Braze REST API key you created above.
3

Select your Braze instance

Choose the regional instance that matches your Braze dashboard (e.g. US-01, EU-01).
4

Choose a customer identifier type

Select how Subtotal should match your customers to Braze user profiles.
You should now see an Active status on the Braze integration page.

​
Configuration

After connecting, you can adjust the integration settings.
SettingDescription
API KeyBraze REST API key. Must have the users.track permission enabled.
Braze InstanceRegional API endpoint for your Braze account. Supported instances: US-01 through US-08, US-10, EU-01, EU-02, AU-01, ID-01, JP-01. Find this from your Braze dashboard URL.
Customer Identifier TypeHow Subtotal matches customers to Braze user profiles: Email (email address), Customer ID (mapped to Braze external_id), or Mobile (phone number).
The customer identifier type determines which field on the Subtotal connection is used to look up the corresponding Braze user profile. Make sure the identifier you choose is consistently set on your connections.