# Joy Loyalty Devkit

#### Joy Loyalty Devkit

Joy Loyalty Devkit is made for developers who want to go beyond the default widget and connect directly to Joy’s loyalty engine.

There are two core toolsets:

**1. REST API v2**

Use this to integrate Joy with any external system—mobile apps, backend services, microservices, custom flows, or third-party platforms. With the API, you can:

* Fetch or update loyalty data (points, activities, rewards, tiers, referrals) from your own applications
* Sync Joy events with external systems like CRM, marketing automation, or custom dashboards
* Trigger loyalty logic from outside Shopify — mobile app events, POS extensions, or custom checkout flows
* Build your own admin tools or internal apps powered by Joy’s reward engine

In short: **API = expand Joy outside the storefront.**

**2. JavaScript SDK**

This SDK is designed specifically for storefront developers (Online Store, Headless storefronts, Hydrogen, custom front-end builds). With it, you can:

* Render loyalty components with your own UI instead of Joy’s default widget
* Use Joy’s logic (reward fetching, points calculation, referral link generation) while keeping full control over layout and styling
* Trigger loyalty actions on the storefront using your own UX patterns
* Build inline experiences—embedded tier badges, checkout loyalty hints, custom reward banners, etc.

In short: **JS SDK = build your own loyalty UI on top of Joy.**