Skip to content

Aug 4, 2026

MilestonesFeatures

The Charm API: your loyalty program, open to your stack

Your loyalty program stopped being a walled garden. The new Charm API is a shop-scoped REST API, so your POS, CRM, ERP or anything else your developers build can read loyalty state and move points, using the same battle-tested logic the app itself runs on.

What you can do with it:

  • Read everything that matters — customers with balances, tiers and referral codes, full points history, program configuration, rewards
  • Award, deduct and adjust points from outside Shopify: in-store purchases, reviews on a third-party platform, support gestures, one-off imports
  • Redeem rewards on a customer's behalf — the API mints the same discount codes and store credit as the widget, with the same limits
  • Exclude or re-enroll customers and pin tiers for edge cases your operations team handles by hand today

Built like infrastructure, not an afterthought:

  • API keys live in Settings → API — granular scopes per key, a read-only preset, and the token shown exactly once. A pause switch stops all API traffic instantly without deleting anything
  • Idempotency everywhere — retries can never award twice or mint two discount codes, even if your integration crashes mid-request
  • Rate limits and daily caps protect your store's Shopify budget, so a runaway script cannot starve checkout or order processing
  • Every write is attributed — points history records which key made each change, so "who adjusted this balance" always has an answer

What this looks like in practice: a bridge from your cash register awards points for in-store receipts, so omnichannel customers see one balance everywhere. Your helpdesk shows the customer's tier next to every ticket, and support grants goodwill points without leaving it. Anything your systems can observe can now earn points: a wholesale portal, a review platform we don't integrate natively, an event check-in.

The full OpenAPI specification is served at /api/v1/openapi.json, and the developer guide lives at docs.charmloyalty.com.

Available on every plan. In line with our no-features-locked-behind-plans principle, the API isn't gated by pricing. Message us in the support chat and we'll switch it on for your store.