Prerequisites
A Starter plan or higher on Mage Loyalty
Okendo installed on your Shopify store
Access to Shopify Flow (available on all Shopify plans)
Step 1: Create the Earning Rule
In your Shopify admin, open the Mage Loyalty app
Navigate to Loyalty Program > Earning Rules
Click Leave a Review
Configure the rule:
Earning rule name — Give the rule a name (e.g. "Leave a Review")
Review app — Select Okendo from the dropdown
Points — Enter the number of points to award per review (e.g. 100)
(Optional) Set a frequency limit to prevent abuse. For example, you can limit customers to earning points for 1 review every 7 days
Make sure the rule is enabled using the status toggle in the sidebar
Click Save
Step 2: Set Up the Shopify Flow
Once the earning rule is saved, you need to create a Shopify Flow that triggers the point award when a customer submits a review in Okendo.
In your Shopify admin, go to Settings > Flow (or search for "Flow" in the admin search bar)
Click Create workflow
Click Select a trigger
Search for Okendo and select the Review Created trigger
Click the + button to add an action
Search for Mage Loyalty and select the Add Points for Review action
Configure the action fields:
Customer email — Map this to the customer's email from the Okendo trigger. This is typically available as
{{email}}.Internal note (optional) — Add any note for internal tracking
Click Turn on workflow in the top right corner
Step 3: Test the Integration
Submit a test review on your store using Okendo
Check that the Shopify Flow ran successfully:
Go to Settings > Flow and click on your workflow
Check the Run history tab for recent executions
Verify the customer received points:
In the Mage Loyalty app, navigate to Customers
Find the customer who left the review and confirm their points balance increased
Frequently Asked Questions
What happens if the same review triggers the flow twice?
Mage Loyalty automatically deduplicates reviews. Each Flow execution has a unique identifier, so the same review will never award points twice.
What if the customer isn't enrolled in the loyalty program?
Points are only awarded to customers who are already part of your loyalty program. If the customer hasn't enrolled yet, the review will be recorded but no points will be given.
Can I use frequency limits?
Yes. When configuring the earning rule, enable the frequency limit option. For example, you can limit customers to earning points for 1 review every 7 days. This prevents abuse while still rewarding genuine reviewers.
Does this work with VIP tier multipliers?
Yes. If your loyalty program has VIP tiers with point multipliers enabled, the multiplier will automatically apply to review points.
Can I set an approval delay?
If your earning rule has an approval time configured, points will be held in a pending state until the approval period has passed. This gives you time to moderate reviews before points are awarded.
Troubleshooting
Points aren't being awarded
Verify the Shopify Flow is turned on and check the run history for errors
Confirm the earning rule is enabled in Mage Loyalty
Make sure the customer email in the Flow action matches the email in your loyalty program
Check that the customer is enrolled in your loyalty program
Flow shows an error
Ensure the customer email field is correctly mapped from the Okendo trigger
Verify your Mage Loyalty app is installed and your subscription is active
Need help?
Use our live chat inside the Mage Loyalty app or email us at [email protected].
