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 tokens | Customers in that shop. |
| A trusted administrative integration | customer-admin tokens | The 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.
Related APIs
| If you want… | Examples | use… |
|---|---|---|
| customer-level access to the loyalty data | Get the customer’s loyalty points | Loyalty API |
| reward customers for performing custom actions in your shop | Give 100 points to customers who customize a product. | Triggers API |