Skip to main content

Braze Integration

T
Written by Travis Brault

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 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 at least one identifier (email and/or phone) and check loyalty status is enabled.
​

Events not firing
​

Is the event enabled in Rivo? Has the customer completed the trigger action? Check whether your campaign or canvas filters are excluding the event.
​

Cross-ESP troubleshooting references

If you run more than one ESP integration, compare behavior with this quick matrix:

Check

Klaviyo

Attentive

Postscript

Braze

Event enablement

Event must be enabled in Rivo

Event must be enabled in Rivo

Event must be enabled in Rivo

Event must be enabled in Rivo

Profile sync prerequisite

Customer profile should exist in Klaviyo (sync customers if needed)

Subscriber profile should exist in Attentive

Subscriber profile should exist in Postscript

Customer profile should exist in Braze

Custom action troubleshooting

Check Rivo Points Earned and filter by trigger/action name

Check Points Earned or Credits Earned and filter by trigger/action name

Check Rivo - PointsEarned and filter by Trigger Name

Check RivoPointsEarned and filter by trigger/action name

Delay expectation

Usually minutes; large syncs can take longer

Usually minutes; can delay during high activity

Usually minutes; large syncs can take longer

Usually minutes; large syncs can take longer

Detailed guides:

For membership lifecycle automations and event behavior, see Membership Integration Events.
​

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

Braze profile updates and loyalty events are sent automatically as customer activity happens. Most stores see updates within minutes, but delays can happen during high activity windows or when large syncs are running.
​

If you need to backfill data, run a manual sync from your Rivo Braze integration settings.

Did this answer your question?