Loyalty Admin API

Loyalty Admin API

Goal: Interact with the loyalty program as a shop admin.

What’s special about this API?

This is a counterpart to the Loyalty API, intended to enable admin-level adjustments to the customers’ loyalty programs.

Authentication

When calling from…authenticate using…Scope
Server side (backend)shop tokensCustomers in that shop.
A trusted administrative integrationcustomer-admin tokensThe customer identified by the token.

Ordinary customer tokens cannot call this API unless Bubblehouse has enabled a legacy compatibility exception for the shop. This exception covers the Loyalty Admin API, preserves customer binding, and does not bypass action-level admin requirements. New integrations must use shop or customer-admin tokens.

Keep shop tokens and customer-admin tokens out of public storefront code and customer-controlled clients. Existing partner-customer access remains supported for compatibility; it does not grant access to actions that require explicit customer-admin authority. Merge and Export remain disabled.

If you want…Examplesuse…
customer-level access to the loyalty dataGet the customer’s loyalty pointsLoyalty API
reward customers for performing custom actions in your shopGive 100 points to customers who customize a product.Triggers API

Previous
UpdateOutcome