Skip to main content

Braze Integration

Written by James Dohm
Updated this week

What’s the Braze + Rivo Integration?

This integration connects your Rivo loyalty program with Braze, allowing you to run smarter, more personalized campaigns based on loyalty actions, like earning points, VIP tier changes, referrals, memberships, and more.

What the integration does

Feature

What it Means

Real-time data sync

Automatically keeps customer data (points, tiers, membership status, etc.) up to date in Braze

Event tracking

Sends loyalty events (e.g., “earned points”, “tier upgrade”) to Braze as custom events

Manual/bulk customer sync

Push all customer profiles into Braze at once

How to Set It Up

What You’ll Need from Braze

Requirement

Details

API Key

Must have “User Data” permissions

REST Endpoint

Your Braze instance URL (e.g. https://rest.iad-01.braze.com)

Setup Steps

  1. In Rivo, go to Integrations

  2. Click Braze

  3. Enter your API Key and REST Endpoint

  4. Choose which loyalty events you want to track

  5. Enable the integration

You can turn the integration on or off at any time without losing your configuration.

Events You Can Track

Loyalty Events

Event Name

Description

Points Earned

When a customer earns points from a purchase or action

Reward Redeemed

When a reward is redeemed

Account Activated

Customer activates their loyalty account

Birthday

Customer’s birthday event (auto-triggered with points)

Birthday Captured

When a customer adds their date of birth

VIP Tier Events

Event Name

Description

Tier Level Up

Customer moves up a VIP tier

Tier Level Down

Customer moves down a tier

Referral Events

Event Name

Description

Referral Completed

A referred friend makes a purchase

Advocate Signup

Customer joins the referral program

Referral Friend Claim

A referred friend claims their reward

Referral Invite Created

An advocate sends a referral invite

Membership Events

Event Name

Description

Membership Signup

Customer signs up for a membership tier

Membership Pending Cancellation

Membership is scheduled to cancel

Membership Canceled

Membership has been canceled

Membership Payment Failure

A membership payment failed

Membership Payment Success

A membership payment succeeded

Membership Renewal Notice

Reminder before upcoming membership renewal

Membership Successful Rebill

Membership was successfully rebilled

Expiry Warnings

Event Name

Description

Reward Expiry Warning

30 days before a reward expires

Reward Expiry Last Chance

3 days before a reward expires

Points Expiry Warning

30 days before points expire

Points Expiry Last Chance

3 days before points expire

You can enable or disable any of these events individually depending on your campaign needs.

What Data Is Synced to Braze

All custom attributes are synced with a rivo_ prefix so they’re easy to identify in Braze.

Core Attributes

Attribute

Description

rivo_balance

Current points or store credit balance

rivo_points_balance

Current points total

rivo_store_credit_balance

Current store credit balance

rivo_loyalty_status

Whether the customer is enrolled in loyalty

rivo_referral_url

Customer’s personal referral link

rivo_date_of_birth

Used for birthday campaign targeting

rivo_points_as_cash_balance

Cash equivalent of points (if configured)

VIP Attributes

Attribute

Description

rivo_vip_tier_name

Current VIP level (if tiers are enabled)

You can optionally exclude VIP tier data from syncing in the integration settings.

Membership Attributes

Attribute

Description

rivo_membership_tier_name

Current membership tier name

rivo_membership_status

Current membership status (active, canceled, paused, etc.)

rivo_membership_joined_date

When the customer first signed up

rivo_membership_started_at

When the current tier subscription started

rivo_membership_next_billing_date_at

Next scheduled charge date

rivo_membership_pending_cancellation_at

When the membership is scheduled to cancel

Store Credit

Attribute

Description

rivo_store_credit_code

Unified gift card code (if store credit is enabled)

This data updates automatically in real time when it changes in Rivo.

Managing the Integration

Manual Syncing

Use this if:

  • You’re setting up Braze for the first time

  • You’re syncing an existing loyalty program

  • You want to refresh all customer data

Manual syncs can be run once per hour. The sync handles large volumes of customers with smart batching and retry logic.

Enabling or Disabling the Integration

You can toggle the integration at any time. Turning it off stops data syncing, but your settings are saved for when you re-enable it.

Removing the Integration

This will:

  • Delete your Braze API key and REST endpoint

  • Stop all syncing

  • Reset all customer integration settings


Troubleshooting

Issue

What to Check

Integration not working

Is your API key valid and has the right permissions? Is the REST endpoint correct? Is the integration enabled?

Data missing in Braze

Wait a few minutes after setup. Make sure customers have emails. Check loyalty status is “enabled”.

Events not firing

Is the event enabled in Rivo? Does the customer have a Braze profile? Did the action meet the trigger condition?

Getting Help

If you’re running into issues:

  • Double-check your Braze API key and endpoint

  • Make sure the integration is enabled in Rivo

  • Review event settings and customer data

  • Reach out to Rivo support with specific errors or behavior you’re seeing


Final Notes

The Braze integration is real-time — loyalty events and profile updates are pushed instantly. It’s built to handle high volumes and stay within Braze’s API limits using batching, rate limiting, and smart retry logic. You get accurate, timely data for every campaign, every time.

Did this answer your question?