Build and deploy rapidly with our SDK, and take full control of every detail with our API.
Access and update your Mage loyalty data via API. Build fully custom solutions using our Developer Toolkit. Handling 6M+ calls daily with 99.98% uptime.
Load first-class loyalty data in the right place at the right time. Create custom displays and interactions with points, rewards, and tier data on the frontend.
Access your Mage data natively inside of Shopify. Build fully custom Liquid templates right inside of Shopify without workarounds.
Get real-time data as it happens. Earning points, spending points, tier upgrades, or custom actions. Build low-code workflows via Shopify Flow.
Build and deploy rapidly with our SDK, and take full control of every detail with our API.
import { MageClient } from '@mage/sdk';
const mage = new MageClient({
apiKey: 'mk_live_...',
storeDomain: 'your-store.myshopify.com'
});
const result = await mage.points.award({
customerId: 'gid://shopify/Customer/12345',
points: 500,
reason: 'Birthday bonus'
});
console.log(result.balance); // 1,250Everything you need to build bespoke loyalty experiences beyond out-of-the-box tools
Embed loyalty redemption directly in Shopify checkout using extensions. Let customers pay with points, reducing fees and friction.
Build on-brand loyalty portals and customer account pages with our components and APIs. Full control over the customer experience.
Style every element of the loyalty experience with CSS. Ready-to-use components and white-labeled widgets that match your brand.
Infrastructure handling 6M+ API calls daily with 99.98% uptime. Built for the latest Shopify tech stack and Shopify Plus stores.
Everything you need to get up and running with the Mage Developer Toolkit.
Browse the full REST API reference with endpoints, parameters, and response examples.
View docsGet started with our JavaScript SDK for building custom frontend loyalty experiences.
SDK referenceJoin our shared Slack channel. Ask questions and connect with the Mage team directly.
Join SlackVisit our getting started guide for the basics of building with Mage developer tools.
Get startedMage provides a REST API for full CRUD operations on loyalty data, a JavaScript SDK for frontend integrations, native Shopify Metafields for Liquid templating, and Webhooks for real-time event notifications. All APIs are designed for the latest Shopify tech stack.
Authentication uses API keys generated from your Mage dashboard. Include your key in the Authorization header as a Bearer token. The JavaScript SDK accepts the key during client initialization. All API traffic is encrypted over HTTPS.
Yes. The REST API and JavaScript SDK work with any frontend framework—Hydrogen, Next.js, Remix, or custom builds. Mage is designed to be frontend-agnostic, so you can load loyalty data wherever your storefront lives.
Configure webhook endpoints in your Mage dashboard. We send signed POST requests for events like points.earned, points.redeemed, tier.upgraded, and more. All payloads include a signature header for verification. You can also use Shopify Flow for low-code automation.
Mage handles 6M+ API calls daily across all merchants. Rate limits are generous and scale with your plan. If you need higher limits for a specific integration, contact our developer support team and we can accommodate custom requirements.
Yes—24/7 developer support via our shared Slack channel. You can also reach out through email or schedule a call with our engineering team. We provide code reviews for complex integrations and can help debug issues in real time.
Mage syncs loyalty data (points balance, tier, rewards) into Shopify Metafields automatically. This means you can access customer loyalty data directly in your Liquid templates without any API calls—perfect for theme customizations and server-rendered pages.