Shopify Admin GraphQL API
Manage a Shopify store: products and variants, inventory, orders, customers, metafields, webhooks and bulk exports.
E-commerceGuided#shopify#graphql#ecommerce#products#orders#inventory
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Shopify Admin GraphQL API is how apps and back-office systems manage a Shopify store: products and variants, inventory, orders, customers, metafields, webhooks and large exports. It is Shopify's primary admin API (the REST Admin API has been legacy since October 2024, and new public apps must use GraphQL). This collection runs the common jobs against version 2026-10, the latest stable release on 17 November 2026.
Get an access token
Admin-created custom apps can no longer be made, so new integrations start in the Dev Dashboard:
- Open the Dev Dashboard, go to Apps > Create app > Start from Dev Dashboard and name the app.
- Open Versions, create a version, choose the Admin API Scopes you need (for this collection:
read_products,write_products,read_inventory,write_inventory,read_locations,read_orders,read_customers,write_customers) and Release it. - In Dev stores, create a development store, then Install app on it.
- Under the app's Settings, copy the Client ID and Client secret into
clientIdandclientSecret, then run Get an access token. This client credentials grant works for stores in your own organization and returns a token valid for 24 hours. - For merchants' stores outside your organization, use the OAuth install flow (authorization code grant or token exchange) instead. If you already have a token from a legacy custom app, just paste it into
accessToken; it does not expire, so guard it like a password.
Guides: Dev Dashboard apps, client credentials grant.
Authentication, base URL and versions
Send every request as POST https://{shop}.myshopify.com/admin/api/2026-10/graphql.json with the header X-Shopify-Access-Token: <token> and a JSON body of query and variables (this collection's GraphQL body mode builds it). Shopify releases a new version every quarter and supports each for at least 12 months; if you call a retired version, it answers with the oldest supported one, and the X-Shopify-API-Version response header tells you which was used. Update apiVersion deliberately after reading the release notes.
How to use this collection
Fill shopDomain, get a token, run 1. Start here, then each folder in order. List and create requests save global IDs (gid://shopify/...) into variables, so the follow-up requests work without copying.
Throttling and query cost
Limits are measured in points, not requests. Each response includes extensions.cost (requestedQueryCost, actualQueryCost and throttleStatus with the bucket size, what is left and the restore rate per second). The restore rate depends on the store's plan, and a single query may cost at most 1,000 points. Ask only for the fields you need, keep page sizes modest, and use bulk operations for exports. See GraphQL Admin rate limits.
Common errors
| What you see | Meaning | What to do |
|---|---|---|
| HTTP 401 | Missing, wrong or expired token | Run Get an access token again or check the header. |
errors with ACCESS_DENIED | The token lacks a scope | Add the scope to a new app version, release it, approve on the store. |
errors with THROTTLED | Point bucket empty | Wait for it to refill (at least 1 second), then retry. |
userErrors in a mutation | Invalid input (HTTP 200) | Read field and message; nothing was saved. |
| HTTP 402 / 423 | Store frozen or locked | The store must resolve its account status. |
| HTTP 404 | Wrong shop domain or path | Use the .myshopify.com domain and /admin/api/<version>/graphql.json. |
INTERNAL_SERVER_ERROR / 5xx | Shopify-side problem | Retry with backoff; check Shopify's status page. |
Pricing and docs
The Admin API is free to use; stores pay for their Shopify plan, and the plan sets the rate-limit restore rate. Reference: GraphQL Admin API, bulk operations, API limits.
Endpoints 18
1. Start here
- POSTGet an access token (client credentials)
https://{{shopDomain}}/admin/oauth/access_tokenFor an app you created in the Dev Dashboard and installed on a store in the same Shopify organization (for example a dev store you created there), exchange… - POSTShop info (and query cost)
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonThe cheapest useful query: it returns the store the token belongs to, so it proves shopDomain, apiVersion and accessToken are right. Query cost: every…
2. Products and variants
- POSTList products (cursor pagination)
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonReturns products 10 at a time. GraphQL lists are connections: read nodes, and if pageInfo.hasNextPage is true, pass pageInfo.endCursor as after to get the… - POSTGet one product with variants
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonFetches one product by its global ID (gid://shopify/Product/..., saved into productId by the list or create requests) with its variants. Each variant has a… - POSTproductCreate
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonCreates a product with its first (default) variant. Pass the fields in the product input (ProductCreateInput): title, descriptionHtml, vendor, productType,… - POSTproductUpdate
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonChanges product-level fields. Pass id plus only the fields to change in the product input (ProductUpdateInput). Here the product is renamed, re-tagged and set… - POSTproductVariantsBulkUpdate: price and SKU
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonUpdates one or more variants of a single product (productId). Each entry in variants needs the variant id (saved as variantId) plus the fields to change:…
3. Inventory
- POSTList locations
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonLists the store's active locations (warehouses, shops). Inventory quantities live on an inventory item at a location, so you need a location ID for Adjust… - POSTAdjust inventory (inventoryAdjustQuantities)
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonChanges stock by a relative amount (delta: +10 receives stock, -2 removes it); it does not set an absolute number. Each change names an inventoryItemId (from…
4. Orders
- POSTList recent orders
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonReturns the newest orders first (reverse: true on the default PROCESSED_AT sort). Filter with query, for example financial_status:paid,… - POSTGet one order
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonFetches one order (orderId) with its line items, customer and shipping address. Use it when a webhook tells you an order was created or paid. lineItems is a…
5. Customers
- POSTList customers
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonLists customers with their default email and phone, order count and total spent. Filter with query (for example tag:vip or country:India) and page with… - POSTcustomerCreate
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonCreates a customer. At least one of email, phone or name is required. Marketing consent can be recorded with emailMarketingConsent (marketingState,…
6. Metafields
- POSTmetafieldsSet
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonCreates or updates up to 25 metafields in one atomic call (all saved or none). Each needs ownerId (any resource GID, here the product), namespace, key, type…
7. Webhooks
- POSTwebhookSubscriptionCreate
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonSubscribes your endpoint to a topic such as ORDERS_CREATE or APP_UNINSTALLED (see the topic list in the docs). uri is your HTTPS URL (Google Pub/Sub and… - POSTList webhook subscriptions
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonLists the webhook subscriptions this app created on the store, optionally filtered by topics. Use it to check for duplicates before creating one. The…
8. Bulk operations
- POSTRun a bulk query
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonStarts an asynchronous export. Pass an ordinary query as a string (no first limits needed on the outer connection; it must contain at least one connection, up… - POSTPoll the bulk operation
https://{{shopDomain}}/admin/api/{{apiVersion}}/graphql.jsonChecks progress with bulkOperation(id:) (the older currentBulkOperation is deprecated). status goes CREATED -> RUNNING -> COMPLETED (or FAILED / CANCELED);…
API details
- Base URL
https://{shop}.myshopify.com/admin/api/2026-10/graphql.json- Authentication
- An API key in the X-Shopify-Access-Token header
- Operations
- 18 operations on 18 pathsPOST 18
- Main resources
- 1. Start here 22. Products and variants 53. Inventory 24. Orders 25. Customers 26. Metafields 17. Webhooks 28. Bulk operations 2
- Description format
- Swastik Codes guided collection, API version
checked against the docs on 2026-11-17 - Links
- Documentation
How to test the Shopify Admin GraphQL API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Shopify Admin GraphQL API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-Shopify-Access-Token header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Get an access token (client credentials)” (POST https://{{shopDomain}}/admin/oauth/access_token), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Shopify Admin GraphQL API?
Manage a Shopify store: products and variants, inventory, orders, customers, metafields, webhooks and bulk exports. It is listed under E-commerce and has 18 endpoints.
Who publishes the Shopify Admin GraphQL API?
It is listed from Shopify's public API description (an OpenAPI document), not published by Shopify on Swastik Codes. Anyone who controls shopify.dev can claim the profile by adding a DNS TXT record.
What is the base URL of the Shopify Admin GraphQL API?
Requests go to https://{shop}.myshopify.com/admin/api/2026-10/graphql.json. Endpoint paths are added to this base URL.
How do I authenticate with the Shopify Admin GraphQL API?
With an API key in the X-Shopify-Access-Token header.
How many endpoints does the Shopify Admin GraphQL API have?
18 operations on 18 paths (18 POST). The largest groups are 1. Start here, 2. Products and variants, 3. Inventory, 4. Orders.
Is forking the Shopify Admin GraphQL API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.