Quickstart
- Install the app and open API Access in Shopify admin.
- Create a scoped token for your integration use case.
- Send `Authorization: Bearer YOUR_TOKEN` on each API request.
- Handle structured error codes and rate-limit headers safely.
Developer docs
Build secure integration flows for locations, prices, and runtime price resolution using scoped API tokens.
Scopes
Read synced Shopify location records.
Read location prices, location groups, price rules, catalog lookups, and resolution endpoints.
Create, update, and delete pricing data (including rules/groups), plus trigger runtime checks.
Reserved for sync workflows. Keep for forward compatibility when creating broad integration tokens.
Error handling
Error responses use a structured envelope with `ok: false`, an error code, and a safe message.
| Code | Status | Meaning |
|---|---|---|
API_TOKEN_UNAUTHORIZED | 401 | Missing, malformed, expired, or revoked bearer token. |
API_TOKEN_FORBIDDEN | 403 | Token is valid but does not include the required scope. |
RATE_LIMIT_EXCEEDED | 429 | Too many requests in the current rate-limit window. |
PLAN_LIMIT_EXCEEDED | 403 | Feature is not available on the current billing tier. |
VALIDATION_ERROR | 400 | Request body or query parameters are invalid. |