Shopify

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:

  1. Open the Dev Dashboard, go to Apps > Create app > Start from Dev Dashboard and name the app.
  2. 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.
  3. In Dev stores, create a development store, then Install app on it.
  4. Under the app's Settings, copy the Client ID and Client secret into clientId and clientSecret, 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.
  5. 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 seeMeaningWhat to do
HTTP 401Missing, wrong or expired tokenRun Get an access token again or check the header.
errors with ACCESS_DENIEDThe token lacks a scopeAdd the scope to a new app version, release it, approve on the store.
errors with THROTTLEDPoint bucket emptyWait for it to refill (at least 1 second), then retry.
userErrors in a mutationInvalid input (HTTP 200)Read field and message; nothing was saved.
HTTP 402 / 423Store frozen or lockedThe store must resolve its account status.
HTTP 404Wrong shop domain or pathUse the .myshopify.com domain and /admin/api/<version>/graphql.json.
INTERNAL_SERVER_ERROR / 5xxShopify-side problemRetry 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 variantshttps://{{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…
  • POSTproductCreatehttps://{{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,…
  • POSTproductUpdatehttps://{{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 SKUhttps://{{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 locationshttps://{{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 ordershttps://{{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 orderhttps://{{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 customershttps://{{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…
  • POSTcustomerCreatehttps://{{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

  • POSTmetafieldsSethttps://{{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

  • POSTwebhookSubscriptionCreatehttps://{{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 subscriptionshttps://{{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 queryhttps://{{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 operationhttps://{{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

How to test the Shopify Admin GraphQL API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Shopify Admin GraphQL API collection, without the publisher's secrets.
  3. 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.
  4. 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.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.