--- title: "Build loyalty your way" url: "https://joy.so/developers/" kind: "page" description: "Your frontend. Your workflows. Joy’s loyalty engine. Build the experience your brand deserves, with developer tools that put you in control." --- # Build loyalty your way Your frontend. Your workflows. Joy’s loyalty engine. Build the experience your brand deserves, with developer tools that put you in control. Explore developer docs: https://devdocs.joy.so/ ## A toolkit that goes where you build Design a custom member experience, connect the rest of your stack, or automate the moments in between. Choose the right tools for your next idea. ### MCP & AI connections Connect Claude or ChatGPT to live loyalty data. Grant read access or approved actions, with connections you can revoke. (Scoped access · OAuth) Read the connection guide: https://help.joy.so/settings/developers/connect-claude-and-chatgpt/ ### JavaScript SDK Bring points, rewards and loyalty actions into your own storefront UI. You own the layout and interactions. (Your storefront, your components) Explore the SDK: https://devdocs.joy.so/joy-javascript-api/ ### REST API v2 Read and update customers, points, rewards, tiers and referrals from your backend or custom application. (Server-side · Ultimate plan) View API reference: https://devdocs.joy.so/joy-rest-api-v2/rest-api-v2/ ### Webhooks Connect loyalty events to your CRM, messaging platform or internal tools. Respond when points and tiers change. (Event-driven · Ultimate plan) Explore webhooks: https://devdocs.joy.so/webhook-api/webhook-api/ ### Shopify metafields Sync point balances and VIP tier names to Shopify customer metafields. Put loyalty data to work across your Shopify stack. (Native customer data · Essential+) Explore metafields: https://help.joy.so/settings/general/sync-metafields/ ### Shopify Flow Turn loyalty events into workflows. Connect points, rewards and customer activities with the apps your team already uses. (Low-code workflows · Essential+) View triggers and actions: https://help.joy.so/integrations/integrate-with-shopify-flow/ ## Bring your loyalty tools into Claude & ChatGPT Connect through MCP to explore live loyalty data and preview program changes in your assistant. OAuth keeps access scoped and revocable. - Generate the matching key in Joy’s developer settings. - Copy your MCP server URL and add it to your assistant. - Choose read-only or full access, then approve the connection. Connect Claude or ChatGPT: https://help.joy.so/settings/developers/connect-claude-and-chatgpt/ ## Build a reward browser with the SDK Read Joy’s redeeming programs and render them with your own storefront components. The SDK supplies the loyalty data; your code controls the interface. - Wait for joy:ready before calling the SDK. - Read the available programs with redeemPrograms(). - Inspect the returned programs and map them into your own reward UI. Read the SDK methods: https://devdocs.joy.so/joy-javascript-api/ ## Read customers from your backend Connect a mobile experience. Build an internal tool. Sync your CRM. Use the REST API for loyalty operations and webhooks to keep your systems in step. Ultimate plan required. Keep API secrets on your server. - Explore REST API v2: https://devdocs.joy.so/joy-rest-api-v2/rest-api-v2/ - Connect with webhooks: https://devdocs.joy.so/webhook-api/webhook-api/ ## Loyalty in motion. At scale Millions of storefront requests flow through Joy’s widget backend. Here’s a measured snapshot of that traffic in production. | Metric | Value | | --- | --- | | Storefront requests in 7 days | 32.2M | | Requests per day | ~4.6M | | HTTP 200 responses | 99.2% | Source: Cloud Monitoring · 3–10 August 2026 · Widget popup backend traffic, not total developer REST API usage. View live API status: https://joyloyalty.statuspage.io/ ## Compose loyalty events in Shopify Flow An earned point. A redeemed reward. Build the workflow that follows, with Joy triggers and actions inside Shopify Flow. ### Manage VIP tier on subscription membership status changes Automatically removes or reassigns customers from VIP tiers when subscription memberships are cancelled. ### Assign VIP tier when subscription membership is purchased Automatically assigns customers to VIP tiers when they purchase subscription membership packages. ### Reward weekend signup with bonus Automatically reward customers who sign up during the weekend with a bonus along with their basic signup reward. ### Reply and reward points when customer comments on Instagram post Automatically reply to Instagram comments and send a DM when a customer comments on your post. ### Send DM and reward points when customer mentions your brand on Instagram story Automatically send a thank-you DM and award loyalty points when a customer mentions your brand in their Instagram story. ### Send DM and reward points when customer replies to your Instagram story Automatically send a thank-you DM and award loyalty points when a customer replies to your Instagram story. Essential+. Available actions depend on your plan and connected apps. Explore triggers and actions: https://help.joy.so/integrations/integrate-with-shopify-flow/ ## Distinct brands. Loyalty built around them From member migrations to tailored reward experiences, see what established brands build with Joy. ### Songmont 200K+ members migrated — https://joy.so/case-study/songmont/ ### Allbirds A new home for loyalty — https://joy.so/case-study/allbirds/ ### The Game Collection Rewards for a gaming community — https://joy.so/case-study/thegamecollection/ ## Before you build ### Can I build my own loyalty interface? Yes. The JavaScript SDK exposes customer information, earning and redeeming programs, tiers and widget actions so you can build a storefront interface around Joy’s loyalty logic. ### Which plan includes REST API and webhooks? Unlimited REST API and webhooks are on the Ultimate plan. Shopify Flow and Shopify metafield sync are available from Essential upwards. ### Can I use Joy with a headless storefront? Yes. The JavaScript SDK is framework-agnostic, so you can build custom loyalty UIs on a headless storefront in React, Vue or Hydrogen. ### Do AI connections have unrestricted access? No. An AI connection is scoped when you approve it — you choose read-only or full access, and you can revoke the connection at any time from your developer settings. ## Open the reference. Start building Open developer docs: https://devdocs.joy.so/