Shopify Flow

Where to find this: Shopify admin → Apps → Yuko Loyalty → Integrations → Shopify Flow

Introduction

The Shopify Flow integration sends Yuko events to Shopify Flow as workflow triggers. Anything Flow can do next, such as tagging a customer, notifying staff or updating a metafield, can run when a customer earns points, moves up a VIP tier or completes a referral. Each trigger carries the customer’s loyalty profile plus details about the event, so you can use them in Flow conditions and actions. Yuko also adds one Flow action, Yuko Add Points for Review, which lets other reviews apps award points through your Write a review earn rule.

When to use

You already automate your store with Shopify Flow.
You want loyalty events to drive Shopify-native actions (customer tags, staff alerts, metafields).
You use a reviews app other than Judge.me and want reviews to earn loyalty points.

Before you start

Shopify Flow is installed on your store.

Yuko is installed and your loyalty program is enabled.

Set up the triggers

Enable the integration

In Yuko, go to Apps → Yuko Loyalty → Integrations → Shopify Flow and switch the toggle on. The status badge changes to Enabled.

Choose the events to send

In the Events section, select the Yuko events you want to send to Shopify Flow, then click Save Events. Only selected events are sent.

Build a workflow in Shopify Flow

In Shopify admin, open Shopify Flow, create a workflow and pick a Yuko trigger, for example Yuko VIP Tier Upgrade. Add conditions and actions as usual, then turn the workflow on.

Send test events (optional)

Back in Yuko, click Send Test Events to send sample data for the selected events, so you can check your workflows.

Available triggers

Shopify Flow trigger	Event in Yuko	Fires when
Yuko Loyalty Program Joined	Joined Loyalty Program	A customer joins the loyalty program.
Yuko Loyalty Earn Reward	Earn Points	A customer earns loyalty points.
Yuko Loyalty Redeem Points	Redeem Points	A customer redeems points for a reward.
Yuko Reward Expiring	Reward Expiry Reminder	A redeemed reward is about to expire.
Yuko Points Expiring	Points Expiring Reminder	A customer’s points are about to expire.
Yuko Loyalty Birthday Reminder	Birthday Reminder	A customer’s birthday is coming up and your Birthday earn rule is active.
Yuko Loyalty Anniversary Reminder	Anniversary Reminder	A customer’s loyalty anniversary is coming up and your Anniversary earn rule is active.
Yuko VIP Tier Entry	VIP Tier Entry	A customer enters a VIP tier for the first time.
Yuko VIP Tier Upgrade	VIP Tier Upgrade	A customer moves up to a higher VIP tier.
Yuko VIP Tier Downgrade	VIP Tier Downgrade	A customer drops to a lower VIP tier.
Yuko Referral Friend Reward Claimed	Friend reward unlocked	A referred friend claims their reward.
Yuko Referral Completed	Referral Completed	A referral is completed.
Yuko Referral Advocate Rewarded	Referrer Rewarded	The referrer receives their reward.

Trigger data

Every trigger passes two objects to Flow: Yuko Customer and Yuko Payload.

Yuko Customer (all triggers)

Group	Fields
Profile	`yuko_email`, `yuko_first_name`, `yuko_last_name`, `yuko_phone_number`, `yuko_platform_customer_id`, `yuko_shopify_customer_id`, `yuko_joined_at`, `yuko_total_spent`, `yuko_date_of_birth`, `yuko_loyalty_anniversary_date`
Points	`yuko_points_balance`, `yuko_points_as_cash_balance`, `yuko_lifetime_points_earned`, `yuko_points_expire_at`, `yuko_points_to_next_reward`
Points expiring soon	`yuko_points_expiring_in_30_days`, `yuko_points_expiring_in_7_days`, `yuko_points_expiring_in_30_days_as_cash_balance`, `yuko_points_expiring_in_7_days_as_cash_balance`
VIP	`yuko_vip_tier`, `yuko_vip_tier_entry_date`, `yuko_vip_retention_expires_at`, `yuko_vip_qualifying_value`, `yuko_vip_next_tier`, `yuko_vip_next_tier_amount_needed`, `yuko_vip_progress_percentage`, `yuko_vip_at_risk`, `yuko_vip_is_entry_tier`
Referrals	`yuko_referral_url`, `yuko_referral_code`, `yuko_total_referrals`, `yuko_successful_referrals`
Membership	`yuko_membership_tier`, `yuko_membership_status`, `yuko_membership_renewal_date`

The 30-day expiring values include the points expiring in the next 7 days.

Yuko Payload (per trigger)

Trigger	Fields
Loyalty Program Joined	`yuko_signup_source`, `yuko_signup_points_awarded`, `yuko_new_balance`, `yuko_entry_tier_name`, `yuko_entry_tier_is_entry`, `yuko_first_reward_name`, `yuko_first_reward_points_required`, `yuko_first_reward_points_needed`, `yuko_referral_code`, `yuko_referral_url`, `yuko_all_tiers`, `yuko_earning_rule`
Loyalty Earn Reward	`yuko_points_earned`, `yuko_new_balance`, `yuko_trigger_name`, `yuko_trigger_order_id`, `yuko_trigger_order_total`, `yuko_earning_rule`, `yuko_vip_tier_multiplier`, `yuko_base_points`, `yuko_bonus_points`, `yuko_total_redeemable_cash`, `yuko_available_rewards_count`, `yuko_points_to_next_reward`, `yuko_points_as_cash`
Loyalty Redeem Points	`yuko_points_spent`, `yuko_new_balance`, `yuko_reward_type`, `yuko_reward_value`, `yuko_reward_code`, `yuko_reward_expires_at`, `yuko_reward_minimum_purchase`, `yuko_reward_description`
Reward Expiring	`yuko_reward_type`, `yuko_reward_value`, `yuko_reward_code`, `yuko_reward_expires_at`, `yuko_reward_description`, `yuko_days_until_expiry`, `yuko_urgency`
Points Expiring	`yuko_points_at_risk`, `yuko_total_balance`, `yuko_expires_at`, `yuko_days_until_expiry`, `yuko_urgency`, `yuko_prevention_action`, `yuko_points_as_cash_at_risk`, `yuko_available_reward_1_name`, `yuko_available_reward_2_name`
Loyalty Birthday Reminder	`yuko_birthday_points_awarded`, `yuko_new_balance`, `yuko_birthday_base_points`, `yuko_birthday_tier_bonus`, `yuko_birthday_tier_multiplier`, `yuko_current_vip_tier`
Loyalty Anniversary Reminder	`yuko_years_as_member`, `yuko_anniversary_points_awarded`, `yuko_new_balance`, `yuko_lifetime_points_earned`, `yuko_lifetime_orders`, `yuko_lifetime_spend`, `yuko_current_vip_tier`
VIP Tier Entry	`yuko_tier_name`, `yuko_tier_id`, `yuko_tier_icon_url`, `yuko_tier_is_entry`, `yuko_benefits_unlocked`, `yuko_all_tiers`, `yuko_next_tier_name`, `yuko_next_tier_threshold`, `yuko_next_tier_amount_needed`, `yuko_next_tier_progress_percentage`, `yuko_earning_rate`, plus up to three tier rewards (`yuko_reward_1_type`, `_value`, `_description`, `_code`, `_expires_at`, and the same for rewards 2 and 3)
VIP Tier Upgrade	`yuko_previous_tier_name`, `yuko_previous_tier_id`, `yuko_new_tier_name`, `yuko_new_tier_id`, `yuko_new_tier_icon_url`, `yuko_qualifying_value`, `yuko_threshold_crossed`, `yuko_qualifying_event_type`, `yuko_qualifying_event_order_id`, `yuko_qualifying_event_order_total`, `yuko_benefits_unlocked`, `yuko_new_earning_rate`, `yuko_previous_earning_rate`, `yuko_next_tier_name`, `yuko_next_tier_threshold`, `yuko_next_tier_amount_needed`, `yuko_next_tier_progress_percentage`, `yuko_tier_stats_percentile`, `yuko_tier_stats_total_in_tier`, `yuko_all_tiers`, plus up to three tier rewards (same fields as VIP Tier Entry)
VIP Tier Downgrade	`yuko_previous_tier_name`, `yuko_new_tier_name`, `yuko_new_tier_icon_url`, `yuko_qualifying_value`, `yuko_previous_threshold`, `yuko_new_threshold`, `yuko_shortfall`, `yuko_benefits_lost`, `yuko_benefits_retained`, `yuko_regain_tier_name`, `yuko_regain_amount_needed`
Referral Friend Reward Claimed	`yuko_friend_email`, `yuko_friend_first_name`, `yuko_referral_code_used`, `yuko_friend_reward_type`, `yuko_friend_reward_value`, `yuko_friend_reward_code`, `yuko_friend_reward_expires_at`, `yuko_friend_reward_description`, `yuko_referred_by`, `yuko_total_claims`, `yuko_total_conversions`, `yuko_claim_source`
Referral Completed	`yuko_friend_email`, `yuko_friend_first_name`, `yuko_friend_order_id`, `yuko_friend_order_total`, `yuko_friend_discount_used`, `yuko_friend_discount_amount`, `yuko_advocate_reward_type`, `yuko_advocate_reward_value`, `yuko_advocate_reward_code`, `yuko_advocate_reward_expires_at`, `yuko_advocate_reward_status`, `yuko_stat_total_referrals`, `yuko_stat_successful_referrals`, `yuko_stat_total_earned`, `yuko_stat_pending_rewards`
Referral Advocate Rewarded	`yuko_reward_type`, `yuko_reward_value`, `yuko_reward_code`, `yuko_reward_expires_at`, `yuko_triggered_by_friend`, `yuko_stat_total_referrals`, `yuko_stat_successful_referrals`, `yuko_stat_total_earned`, `yuko_points_awarded`, `yuko_new_points_balance`, `yuko_reward_description`

In the birthday and anniversary reminders, yuko_birthday_points_awarded and yuko_anniversary_points_awarded hold the points your earn rule is set to award.

The Add Points for Review action

If your reviews app can trigger Shopify Flow, use the Yuko Add Points for Review action to award review points. Each run counts as a published review and earns points through your Write a review earn rule.

Field	What to map
Customer identifier	The reviewer’s customer ID or email from your reviews app’s trigger.
Product ID	The Shopify product ID of the reviewed product.
Photo Url	The review’s photo URL. If it has a value, the review also earns the media bonus when Enable Media Earning is on.

Turn on Write a review

Enable the Write a review earn rule in Yuko and set the points.

Create the Flow workflow

In Shopify Flow, start with your reviews app’s “review created” (or similar) trigger.

Add the Yuko action

Add the Yuko Add Points for Review action and map the three fields from the trigger.

Turn on the workflow

New reviews now earn loyalty points.

The action needs a customer and a product that already exist in Yuko; otherwise the run fails. Points are awarded once per customer per product, and the media bonus once.

Using Judge.me? Use the Judge.me integration instead. It connects directly without Shopify Flow.

Example use cases

Tag VIPs: Yuko VIP Tier Upgrade → condition on yuko_new_tier_name → add a customer tag such as vip-gold.
Points expiry outreach: Yuko Points Expiring → condition on yuko_points_at_risk → send an internal email to your retention team.
Birthday prep: Yuko Loyalty Birthday Reminder → add a birthday-this-month tag for a store-wide campaign.
Referral alert: Yuko Referral Completed → condition on yuko_friend_order_total → notify staff in Slack.

Limitations

Selected events only. Yuko sends only the events you selected and saved.
Shopify Flow limits apply. Flow has its own run limits; see Shopify’s documentation.
Review points need a supported app. The Add Points for Review action works with any reviews app that triggers Shopify Flow and exposes the customer, product and photo fields.

Best practices

Use Flow for Shopify-native side effects (tags, metafields, staff notifications). Use Yuko Workflows for loyalty-side automations such as emails, WhatsApp messages and points.

Don’t duplicate logic in both tools. Pick one home for each automation.

Send test events before going live so you can check field mappings in Flow.

FAQs

How is this different from Yuko Workflows?

Yuko Workflows are loyalty-native (emails, WhatsApp, points, coupons). Shopify Flow is Shopify-native (tags, orders, staff alerts). Use each for what it does best.

Why isn't my Flow workflow firing?

Check that the Shopify Flow integration is Enabled in Yuko, that the event is selected under Events and saved, and that the Flow workflow is turned on.

Do I need to enable the integration to use the Add Points for Review action?

The action comes with the Yuko app in Shopify Flow. It needs the Write a review earn rule to be active so the review can earn points.

REST API

Read and write Yuko data programmatically.

Webhooks

Receive real-time event notifications.

Trigger Shopify Flow workflows from Yuko loyalty, VIP and referral events.

Shopify POS

Redeem points and apply loyalty discounts at the till.

Klaviyo

Sync customers, points and tier data into Klaviyo.

Omnisend

Sync loyalty data into Omnisend.

Send transactional loyalty messages via 13 supported WhatsApp Business API providers.

Retainful

Email marketing & abandoned cart recovery.

Judge.me

Award loyalty points for Judge.me reviews.

Book a Free Setup Call

Talk to our team for personalised setup help.Time: 30 minutes

Contact Support

Visit our support hub for help articles, live chat and ticket submission.

Browse the Guides

Documentation across loyalty, referrals, memberships and more.

Install Yuko

Add Yuko to your Shopify store from the Shopify App Store.

​Introduction

​When to use

​Before you start

​Set up the triggers

​Available triggers

​Trigger data

​Yuko Customer (all triggers)

​Yuko Payload (per trigger)

​The Add Points for Review action

​Example use cases

​Limitations

​Best practices

​FAQs

​Related

REST API

Webhooks

Shopify Flow

Shopify POS

Klaviyo

Omnisend

WhatsApp

Retainful

Judge.me

Book a Free Setup Call

Contact Support

Browse the Guides

Install Yuko

Introduction

When to use

Before you start

Set up the triggers

Available triggers

Trigger data

Yuko Customer (all triggers)

Yuko Payload (per trigger)

The Add Points for Review action

Example use cases

Limitations

Best practices

FAQs

Related