Integrating RightMessage with Braze

What you'll achieve

Connect RightMessage to Braze to automatically sync contacts, custom attributes, events, and purchase data between your site and Braze. This integration lets you segment audiences, personalize content, and trigger campaigns based on real-time behavioral data collected through RightMessage.

Before you begin

You'll need:

• A RightMessage account

• A Braze account with API access

• Your Braze API key with users.track and users.export permissions

• Your Braze REST endpoint URL (regional instance)

Finding your Braze credentials

Get your API key

1. Log into your Braze dashboard

2. Navigate to Settings > API Keys

3. Click Create New API Key

4. Name the key (e.g., "RightMessage Integration")

5. Grant the following permissions:

   • users.track - Required for creating and updating contacts

   • users.export.ids - Required for reading contact data

6. Copy the API key and save it securely

Identify your REST endpoint

Your Braze REST endpoint depends on your regional instance. Common endpoints include:

• https://rest.iad-01.braze.com (US-01)

• https://rest.iad-02.braze.com (US-02)

• https://rest.iad-03.braze.com (US-03)

• https://rest.fra-01.braze.com (EU-01)

Find your instance in the Braze dashboard URL or in Settings > API Settings. Copy the full REST endpoint URL including https://.

Connecting Braze to RightMessage

1. In RightMessage, go to Integrations

2. Find the Braze card and click it

3. Enter your API Key in the first field

4. Enter your REST Endpoint in the second field (e.g., https://rest.iad-01.braze.com)

5. Click Connect

You'll see a success message when the connection completes. RightMessage tests the connection by fetching your Braze segments.

How data syncs between RightMessage and Braze

Contact creation and updates

RightMessage automatically creates or updates contacts in Braze when visitors submit a RightMessage form.

Contacts are identified by email address and stored using Braze's user alias system. New contacts appear in Braze within 1-5 seconds (Braze doesn't add contacts in realtime.)

Custom attributes

RightMessage syncs custom attributes bidirectionally:

• To Braze: Form responses, quiz answers, and segment data push to Braze as custom attributes

• From Braze: You can pull existing custom attributes into RightMessage segments and personalization rules

Braze supports unstructured custom attributes (strings, numbers, booleans, dates). Object and array types are excluded from sync.

Events and behavioral data

RightMessage tracks custom events in Braze using the /users/track endpoint. You can fire events from RightMessage form submits.

Event history syncs automatically and becomes available in RightMessage segments (e.g., "Has completed webinar signup in last 7 days").

Purchase and revenue tracking

RightMessage supports Braze's purchase tracking, including:

• Product purchases

• Revenue amounts

• Total lifetime revenue per contact

Use revenue data in segments to target high-value customers or personalize content based on purchase history.

Using Braze data in RightMessage

In segments

Create segments based on Braze attributes, events, or revenue:

1. Setup a condition

2. Select Braze as the source

3. Choose the attribute, event, or segment you want to target

4. Set your condition (e.g., "Revenue is greater than $500")

In personalization

Display Braze data using Liquid variables in your content:

Hello {{user.first_name}}, your lifetime revenue is ${{user.total_revenue}}!

All Braze custom attributes are accessible as {{user.attribute_name}}.

Troubleshooting common issues

Connection fails with 401 error

Check that:

• Your API key has users.track and users.export.ids permissions

• The API key is active in Braze (not revoked)

• You've copied the key without extra spaces

Connection fails with 404 error

Verify your REST endpoint URL matches your Braze instance. The endpoint must include the full URL (e.g., https://rest.iad-01.braze.com) and match your account region.

New contacts don't appear immediately

Braze uses eventual consistency. Contacts created via /users/track may take 1-5 seconds to appear in searches or exports. Wait a few seconds and refresh.

Rate limit errors (429)

Braze limits requests to 3,000 per 3 seconds. If you're syncing large volumes of contacts or events rapidly, you may hit this limit. RightMessage handles retries automatically, but consider spreading form submissions or event triggers over time.

Attributes not syncing

Object and array-type custom attributes don't sync between RightMessage and Braze. Use string, number, boolean, or date types instead. Click "Clear Cache" on the integration page to refresh the attribute list.