Welcome to Yotpo's Loyalty and Referrals Developer Hub

Welcome to the Loyalty and Referrals developer hub. You'll find comprehensive guides and documentation to help you start working with Loyalty and Referrals as quickly as possible!

Start here

Welcome Base URL, authentication, and everything you need before your first call. Authentication Find your GUID and API key and authorize your requests. Guidelines & conventions How the Loyalty API is organized and how to work with it.

Build by use case

Pick what you're building. Each path starts with a recipe or a single call. See all paths.

Award points for orders Send customers, orders and refunds from a custom or headless store. Build a customer account page Show points, VIP tier, progress and history in your own UI. Show points on product pages Display "Earn 30 points" with your earning rules and VIP multipliers. Reward custom actions Give points for surveys, app installs and anything outside a purchase. Redeem points for rewards List affordable rewards, redeem one and hand over the coupon code. Run referrals Register referrers, get their link and invite friends.

Build

API Reference Every endpoint — customers, orders, points, redemptions, referrals, and webhooks — with Try It. Recipes Step-by-step walkthroughs: award points, redeem rewards, refunds, and referrals. Guides Integrate Loyalty with a custom or headless store: customers, orders, refunds, rewards and points in your own UI. Changelog The latest changes and updates to the Loyalty API.

More Yotpo APIs

Core API Backend store sync — products, orders, customers, and webhooks. UGC API Reviews, ratings, Q&A, and visual content. App Developer API Build a public app and become a Yotpo technology partner.