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
In Rivo, go to Integrations
Click Braze
Enter your API Key and REST Endpoint
Choose which loyalty events you want to track
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 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
Braze profile attributes are synced with a rivo_ prefix so they’re easy to identify in Braze. Some attributes only appear when the related feature is enabled (for example VIP tiers, memberships, or store credit settings).
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 are queued and processed in batches to handle large customer lists.
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.
