Matrix Rewards API

Read your loyalty programme from your own code, a terminal or an AI assistant, and make two kinds of change: add or take away a member's points, and cancel an unused reward code. You can also have every points movement sent to a web address of your own.

Every call goes to this base address, with a key made in the app:

https://app.matrixrewards.co.uk/api/2026-10

What you can do today

• Account: What this key is and what it reaches.
  • The account this key belongs to, its stores, and the key's own scopes
  • The API keys on this account
  • Stop the key making this request, immediately
• Stores: The stores on the account and their programmes.
  • Every store on this account
  • One store
  • A store's programme: what is stored, the settings in force, what shoppers are actually paid, and the expiry rule
  • Change the earn rate, the bonuses, what a point is worth, referrals, spending any amount, the time zone, the ways to earn, or when points expire
  • The rewards a shopper can spend points on at this store
  • Add a reward shoppers can spend points on
  • Change a reward's cost, value, minimum order or label
  • Remove a reward
  • A store's offers
  • Add an offer: a campaign, a product offer or a channel offer
  • Change an offer
  • Remove an offer
  • The earn rules in force at this store
  • A store's design: the colours, words and look of the rewards panel, the product-page line and the account page
  • Change the design: colours, words, the panel and product-line look, the account page layout, the terms link
  • A store's name and branding as the Matrix Rewards website shows them, and what Shopify has
  • The pictures uploaded to a store, newest first
  • Upload a picture for the store's branding (a logo, a square logo, a cover)
• Members: Shoppers holding points, and the codes they hold.
  • Shoppers on this account
  • One shopper's record
  • The reward codes this shopper holds
  • Add points to a member's balance, or take them away
  • Cancel a reward code and give the member back its points
• Reports: The ledger, liability and settlement.
  • Every points movement on this account, newest first
  • What this account owes its shoppers
  • Points earned at one store and spent at another, inside a window
• Billing: Usage against the plan, and the recorded plan.
  • Orders that earned points this billing month, against the plan's cap
  • The subscriptions recorded for this account
• Log: What every key did, and what it was shown.
  • What every key changed, and what it was shown
• Webhooks: Where every points movement is sent, and a way to check a receiver.
  • The webhook endpoints on this account, and why any stopped
  • Send points movements to an https endpoint
  • Stop sending to an endpoint
  • Send one signed test event now

Not yet

• A command-line tool you can install.
• Adding Matrix Rewards to Claude, ChatGPT and other assistants in one step. Until then, an assistant can use the API only if it can make web requests itself.

Start here

• Authentication: making a key, choosing what it may do, and sending it.
• Safe retries and previews: sending a change twice without making it twice, and seeing a change before it happens.
• Errors: every answer that is not a success, what it means and whether to send it again.
• The reference for version 2026-10: every call, field and answer.

For AI assistants

Give your assistant this address: matrixrewards.co.uk/docs/llms.txt. It is an index of these pages, each linked as plain text. Every page here also has a plain-text twin: add .md to its address.