Skip to main content

Yotpo Reviews Integration

Written by Engineering team

Brevo PushOwl connects to two Yotpo products, and you activate each one separately from Settings → Integrations.

Yotpo Loyalty & Referrals syncs points, tiers, rewards and referral data into Brevo. Yotpo Reviews sends review activity into Brevo, such as a new review or an order becoming eligible for a review request. You can use both in email and SMS automations, as well as in segments.


Yotpo Loyalty Integration

Yotpo Loyalty syncs your customers' loyalty and referral program data into Brevo. You can then segment and automate based on points, tiers, referrals and rewards.

Before you begin
The Yotpo Loyalty & Referrals app must be installed and active in your Shopify store.


🔧 How to Set Up the Integration

  1. Log in to your Brevo PushOwl dashboard.

  2. Complete email onboarding (if you haven't already). Your email setup has to be complete before you connect Yotpo.

  3. Go to Integration settings. In the dashboard, open Settings → Integrations.

  4. Activate Yotpo Loyalty. Find the Yotpo Loyalty tile and click Activate. A popup will ask you to connect your Yotpo account.

  5. Authorize via OAuth. Click Authorize to connect your Yotpo account with Brevo PushOwl. You won't need an API key. Once you authorize, real-time sync starts and your existing loyalty data begins importing automatically.


Historical sync

When you connect, Brevo PushOwl imports the loyalty and referral data your existing members already have in Yotpo. You can segment on points balance, tier or referrals from day one, instead of waiting for each customer's next loyalty event.


Historical sync fills the same contact attributes as real-time sync (see the table below). It runs by itself once you authorize, with nothing to export or upload.

Real-time loyalty events reach Brevo as Yotpo sends them.


Use-cases

  1. Loyalty-based automation

    • Send automated campaigns when customers earn points, redeem rewards, or reach a new tier.

  2. Personalized reward messages

    • Show a customer's points balance, tier or referral count directly in your email or SMS templates.

  3. Referral campaigns

    • Use the synced YOTPO_REFERRAL_CODE or YOTPO_REFERRAL_LINK to send personalized referral invitations and reminders.

  4. Segmentation for retention

    • Segment contacts on attributes such as:

      • Total Points Balance

      • VIP Tier Name

      • Total Purchases

      • Completed Referrals


Channels

You can use Yotpo loyalty and referral data in email and SMS Flows. Other channels aren't supported yet.


Contact Attributes Synced (Yotpo → Brevo)

These attributes are stored on Brevo contacts and can be used for segmentation and personalization. Both real-time sync and historical sync fill them.

Attribute Name

Type

Description

YOTPO_POINTS_BALANCE

Float

Current available points balance

YOTPO_POINTS_EARNED

Float

Total lifetime points earned

YOTPO_REFERRAL_CODE

Text

Customer referral code

YOTPO_REFERRAL_LINK

Text

Shareable referral link

YOTPO_TIER_NAME

Text

Current loyalty / VIP tier

YOTPO_TOTAL_SPEND_CENTS

Float

Lifetime spend (in cents)

YOTPO_TOTAL_PURCHASES

Integer

Total purchases

YOTPO_REFERRALS_COMPLETED

Integer

Completed referrals

YOTPO_VIP_TIER_EXPIRATION

Date

Tier expiration date

YOTPO_BIRTHDAY

Text

Birthday (MM-DD)

YOTPO_ANNIVERSARY

Text

Anniversary (MM-DD)

YOTPO_OPT_IN

Boolean

Loyalty enrollment status

YOTPO_OPT_IN_DATE

Date

Loyalty enrollment date

YOTPO_POINTS_EXPIRE_AT

Date

Points expiration date

YOTPO_NEXT_POINTS_EXPIRE_ON

Date

Next points expiration date

YOTPO_NEXT_POINTS_EXPIRE_AMOUNT

Float

Points expiring next

YOTPO_TIER_ACTIONS_POINTS_EARNED

Float

Tier points earned

YOTPO_TIER_ACTIONS_AMOUNT_SPENT_CENTS

Float

Tier spend amount

YOTPO_TIER_ACTIONS_PURCHASES_MADE

Integer

Purchases contributing to tier

YOTPO_TIER_ACTIONS_REFERRALS_COMPLETED

Integer

Referrals contributing to tier

YOTPO_TIER_MAINTENANCE_POINTS_NEEDED

Float

Points needed to maintain tier

YOTPO_TIER_MAINTENANCE_AMOUNT_CENTS_NEEDED

Float

Spend needed to maintain tier

YOTPO_TIER_MAINTENANCE_PURCHASES_NEEDED

Integer

Purchases needed to maintain tier

YOTPO_TIER_MAINTENANCE_REFERRALS_NEEDED

Integer

Referrals needed to maintain tier

YOTPO_TIER_UPGRADE_POINTS_NEEDED

Float

Points needed for next tier

YOTPO_TIER_UPGRADE_AMOUNT_CENTS_NEEDED

Float

Spend needed for next tier

YOTPO_TIER_UPGRADE_PURCHASES_NEEDED

Integer

Purchases needed for next tier

YOTPO_TIER_UPGRADE_REFERRALS_NEEDED

Integer

Referrals needed for next tier


Event-Level Attributes

On top of contact attributes, each tracked event carries event-level properties. You can use them to personalize the email and SMS messages sent by a specific Flow.

These attributes are available under yotpo_event, and each one is included only when it applies to the event.

Attribute Name

Type

Description

Typical Event (in Brevo)

yotpo_reward_points

Number

Points awarded by the perk

yotpo_loyalty_points_earned

yotpo_perk_history_title

Text

Title / label of the perk in history

yotpo_loyalty_points_earned

yotpo_reward_text

Text

Coupon / reward code text

yotpo_loyalty_redemption_created

yotpo_redemption_option_name

Text

Name of the redemption option (e.g. "10% Off")

yotpo_loyalty_redemption_created

yotpo_redemption_option_amount

Number

Value / amount of the redemption option

yotpo_loyalty_redemption_created

yotpo_redemption_option_description

Text

Description of the redemption option

yotpo_loyalty_redemption_created

yotpo_new_tier_name

Text

Name of the newly earned tier

yotpo_loyalty_tier_earned

yotpo_new_tier_points_multiplier

Number

Points multiplier of the new tier

yotpo_loyalty_tier_earned

yotpo_old_tier_name

Text

Name of the previous tier

yotpo_loyalty_tier_earned, yotpo_loyalty_tier_lost

yotpo_referral_link

Text

Customer referral link

yotpo_loyalty_referral_share

yotpo_referral_code

Text

Referral code (string format for share events)

yotpo_loyalty_referral_share, yotpo_loyalty_referral_product_share

yotpo_product_referral_link

Text

Product-specific referral link

yotpo_loyalty_referral_product_share

yotpo_product_name

Text

Referred product name

yotpo_loyalty_referral_product_share

yotpo_product_image_url

Text

Referred product image URL

yotpo_loyalty_referral_product_share

yotpo_points_needed

Number

Remaining points required (points reminder)

yotpo_loyalty_points_reminder

yotpo_points_previous_balance

Number

Points balance before the change

yotpo_loyalty_points_changed

yotpo_points_current_balance

Number

Points balance after the change

yotpo_loyalty_points_changed

yotpo_points_difference

Number

Net change in points

yotpo_loyalty_points_changed

yotpo_points_changed_reason

Text

Reason the points changed

yotpo_loyalty_points_changed

yotpo_next_points_expire_on

Date

Date when the next points batch expires

yotpo_loyalty_expiration_reminder

yotpo_next_points_expire_amount

Number

Amount of points expiring next

yotpo_loyalty_expiration_reminder

yotpo_days_to_point_expiration

Number

Days remaining until next points expiration

yotpo_loyalty_expiration_reminder

Note:
The full Yotpo customer object is also passed with each event under yotpo_customer. Every field is prefixed with yotpo_ (for example yotpo_points_balance or yotpo_email) for advanced personalization.


Events Tracked from Yotpo → Brevo (via Webhooks)

Note:
All Yotpo loyalty webhook topics arrive in Brevo with a uniform yotpo_loyalty_ event prefix.
The Yotpo Topic(s) column shows the original webhook event sent by Yotpo. The Event Name (in Brevo) column shows the event you'll pick when building a Flow.
Some legacy (swell/*) and newer (loyalty/*, yotpo/*) topics map to the same Brevo event.

Category

Yotpo Topic(s)

Event Name (in Brevo)

Trigger Description

Account

swell/account/created

yotpo_loyalty_account_created

When a loyalty account is created

Loyalty

loyalty/custom/reward/created

yotpo_loyalty_custom_reward_created

When a custom reward is created

Loyalty

loyalty/donation/created

yotpo_loyalty_donation_created

When a donation reward is created

Loyalty

loyalty/opt_in

yotpo_loyalty_opt_in

When a customer opts into the loyalty program

Loyalty

loyalty/opt_out

yotpo_loyalty_opt_out

When a customer opts out of the loyalty program

Anniversary

swell/customer/anniversary, loyalty/customer/anniversary

yotpo_loyalty_customer_anniversary

On customer's loyalty anniversary

Anniversary

swell/anniversary/captured, loyalty/anniversary/captured

yotpo_loyalty_anniversary_captured

When anniversary milestone is captured

Birthday

swell/customer/birthday

yotpo_loyalty_customer_birthday

When customer's birthday is registered

Birthday

swell/birthday/captured

yotpo_loyalty_birthday_captured

When birthday reward is issued

Points

swell/points/changed

yotpo_loyalty_points_changed

When points balance changes

Points

swell/points/earned

yotpo_loyalty_points_earned

When points are earned

Points

swell/points/reminder

yotpo_loyalty_points_reminder

Reminder about customer points

Redemption

swell/redemption/created

yotpo_loyalty_redemption_created

When a reward is redeemed

Redemption

swell/redemption/reminder

yotpo_loyalty_redemption_reminder

Reminder before redemption expires

Tier

swell/tier/earned

yotpo_loyalty_tier_earned

When a customer earns a new tier

Tier

swell/tier/lost

yotpo_loyalty_tier_lost

When a customer loses a tier

Tier

swell/tier/status/changed

yotpo_loyalty_tier_status_changed

When a customer's tier status changes

Referral

swell/referral/completed, yotpo/referral/completed

yotpo_loyalty_referral_completed

When a referral is completed

Referral

swell/referral/share

yotpo_loyalty_referral_share

When a referral link is shared

Referral

yotpo/referral/shared

yotpo_loyalty_referral_shared

When a referral is shared

Referral

swell/referral/share/reminder

yotpo_loyalty_referral_share_reminder

Reminder to share a referral link

Referral

loyalty/referral/product_share

yotpo_loyalty_referral_product_share

When a product referral is shared

Referral

loyalty/referral/product_share/reminder

yotpo_loyalty_referral_product_share_reminder

Reminder to share a product referral

Expiration

loyalty/expiration/reminder

yotpo_loyalty_expiration_reminder

Reminder before points or rewards expire


Disconnecting or uninstalling

If you uninstall Brevo PushOwl from Shopify, the Yotpo Loyalty connection is cleaned up automatically. Brevo PushOwl unregisters its webhook at Yotpo, so loyalty events stop arriving in Brevo. Its access to your Yotpo account is revoked too, and Yotpo's dashboard will show the integration as disconnected. You don't need to do anything on the Yotpo side.

Contact attributes that were already synced stay on your Brevo contacts.


Yotpo Reviews Integration

Connect Yotpo Reviews with Brevo PushOwl to trigger email and SMS automations from your customers' review activity. You can request a review as soon as an order is fulfilled or delivered, and follow up with customers after they leave feedback.

Before you begin
The Yotpo Reviews app must be installed and active in your Shopify store. If it isn't, review events won't sync.During setup you'll be asked to sign in to the Yotpo account linked to this store.

What does this integration do?

When you connect, Brevo PushOwl registers a webhook with Yotpo for you. From then on, Yotpo sends review events to Brevo in real time. Setup uses a secure OAuth connection, so there's no API key to find or paste.

Every event is available as a trigger in your automations. Events also carry the review score, so you can build segments based on how customers rated you.

🔧 How to Set Up the Integration

  1. Log in to your Brevo PushOwl dashboard.

  2. Complete email onboarding (if you haven't already). Your email setup in Brevo PushOwl has to be complete before you continue. [CONFIRM: is SMS onboarding also required to use these events in SMS flows?]

  3. Go to Integration settings. Open Settings → Integrations.

  4. Activate Yotpo Reviews. Find the Yotpo Reviews tile and click Activate. A popup will ask you to connect your Yotpo account.

  5. Authorize the connection. Click Authorize and sign in to Yotpo. Review events start syncing right away, with nothing else to configure.

What can you do with this integration?

Request reviews at the right moment
Start a flow when an order becomes eligible for a review. You can use fulfillment or delivery as the trigger, depending on when you want the request to go out.

Thank customers who leave a review
Send a thank-you email or SMS when a new review comes in. Many brands add a discount code here or use the moment to start a cross-sell flow.

Respond when a review changes
If a customer edits their review, trigger a follow-up. This helps most when a positive review turns negative and your team wants to reach out quickly.

Segment customers by rating
Group customers by the score they gave. Happy reviewers can go into referral or UGC campaigns. Unhappy ones can get a service recovery message before they churn.

Review Events Synced to Brevo

Event

Triggers when

review_request.eligible.on_fulfillment

A product becomes eligible for a review request after the order is fulfilled

review_request.eligible.on_delivery

A product becomes eligible for a review request after the order is delivered

review_submitted

A customer submits a new review

review_updated

A customer edits an existing review

review_submitted_positive

A review is submitted with a score above 3

review_submitted_negative

A review is submitted with a score of 3 or lower

Did this answer your question?