shopifylisted

# /shopify — Admin GraphQL API (multi-store, multi-app) GraphQL against `https://<shop>.myshopify.com/admin/api/<version>/`. Each profile = one `(shop_domain, access_token)` pair → multi-store AND multi-app on the same store (least-privilege scopes per app). Profile resolution: `--profile` → `SHOPIFY_PROFILE` → `~/.shopify/active_profile` → `[default]`. ## Overview GraphQL primary against the Admin API. Each profile = one `(shop_domain, access_token)` pair, supporting multi-store AND multi-app on the same store (least-privilege scopes per app — e.g., separate inventory app vs read-only reporting app). ## When to Use - Querying products / orders / customers / inventory programmatically - Bulk read via `bulkOperationRunQuery` for large catalogs - Inventory adjustments across multiple locations - Draft order creation for B2B / wholesale flows - Multi-store support (parent brand + child stores) ## When NOT to Use - Storefront API (customer-facing) → different API, different auth - Theme development → use Shopify CLI's theme commands - App development → use Shopify CLI's app commands + framework - One-off Liquid changes → admin UI is faster ## Profile config `~/.shopify/credentials` (mode 600): ```ini [default] shop_domain = your-store.myshopify.com access_token = shpat_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx api_version = 2026-04 # bump quarterly require_confirm = true # gate mutations on prod ``` See [examples/shopify-credentials.example](.