Skip to main content
Appstle Bundles helps Shopify merchants create bundle offers, build-a-box flows, and discount experiences. Read configured bundle rules from your server, render build-a-box experiences from the storefront, and — when you want full control of the look and feel — run Appstle’s fixed pricing, dynamic pricing, and volume discount bundles with your own custom storefront UI.

Build bundles with your own storefront UI

Prefer your own design over Appstle’s built-in widgets? Read the bundle rule over the API, render your own selector, and let Appstle’s automatic discount apply the savings at checkout. Start with the headless overview.

​
Available APIs

Appstle Bundles exposes two REST API surfaces. Pick the one that matches where your code runs:
  • Admin API — server-side, authenticated with X-API-Key. For reading configured bundle and discount rules from a backend service. Browse the full reference under Admin API in the sidebar.
  • Storefront API — customer-facing, accessed through Shopify App Proxy. For rendering build-a-box experiences and generating bundle discounts. Browse the full reference under Storefront API in the sidebar.

​
Which API should you use?

  • You need to read configured bundle rules from a backend service
  • You need to read bundle discount rules
  • You are syncing build-a-box rules into another system
  • You are building reporting, auditing, or merchant-support tooling
  • Your code runs anywhere outside a customer’s browser on the storefront
Admin API requests require an X-API-Key header. Keys are created in the Appstle dashboard under Settings → API Key Management. Never expose keys in client-side code.

​
Key features

Bundle rule lookup

Read active bundle rules and discount rules for a store so external systems can mirror merchant configuration.

Build-a-Box experiences

Fetch build-a-box configuration by token or product handle and render bundle selectors in custom storefronts.

Bundle discounts

Generate bundle and shipping discounts for eligible build-a-box selections.

Storefront activity

Record storefront visitor activity for Appstle-powered bundle widgets and customer-facing flows.

​
Base URL

All Admin API endpoints use: 
https://bundles-admin.appstle.com
Storefront API endpoints are accessed through your store’s Shopify App Proxy — no separate base URL is needed.

​
HTTP status codes

All API responses use standard HTTP status codes.
CodeMeaning
200Success
400Bad request — invalid parameters
401Unauthorized — missing or invalid API key
403Forbidden — key lacks required permissions
404Not found
429Rate limit exceeded
500Server error
Error responses follow this shape: 
{
  "error": "Unauthorized",
  "message": "Invalid API key provided",
  "status": 401
}

​
Next steps

Authentication

Create an API key and learn how to authenticate server-side Bundles API calls.

Quickstart

Get an API key and make your first bundle-rule request.

Integration guide

Review the main Admin and Storefront endpoint categories.