Skip to content

What Is the Shopify Admin API?

Definition

The Shopify Admin API is the API that apps and integrations use to read and change a store's data, such as products, inventory, orders and customers. The current version is a GraphQL API secured with an access token and access scopes. The older REST Admin API has been legacy since October 2024.

How the Shopify Admin API works

Everything you can do in the Shopify admin, from creating products to refunding orders, an app can also do through the Admin API. Shopify describes it as the API for apps and integrations that extend the Shopify admin.[1] Inventory syncs, ERP connectors, order exports, bulk price updates and most App Store apps run on it.

The current Admin API is a GraphQL API. Every request is a POST to a single endpoint per store, with the version in the path, for example https://your-store.myshopify.com/admin/api/2026-10/graphql.json. Each request carries an access token in the X-Shopify-Access-Token header.[1] The token is tied to access scopes, which decide what the app may read and write: read_products and write_products cover products, variants and collections, while read_orders and write_orders reach only orders from the last 60 days unless the app also has read_all_orders.[2]

There is also an older REST Admin API, but it has been a legacy API since October 1, 2024, and since April 1, 2025 all new public apps must be built only with the GraphQL Admin API.[3] Existing REST integrations still work, but new features land in GraphQL, so every new integration we build uses GraphQL.

Rate limits, bulk operations and versions

Rate limits. The GraphQL Admin API does not count requests. It counts cost points: each object a query returns costs 1 point, a connection is priced by its first or last argument, and a mutation costs 10 points. Each app and store pair gets a budget that refills every second, and the refill rate depends on the store's plan.[4]

PlanGraphQL Admin API rate limit
Standard plans100 points/second
Advanced200 points/second
Shopify Plus1,000 points/second
Shopify for enterprise (Commerce Components)2,000 points/second

A single query may not exceed 1,000 points on any plan.[4] Array inputs are capped at 250 items on every Shopify API, so large updates are split into batches.[5]

Bulk operations. For large exports, such as every product or a year of orders, bulk operations run the query asynchronously and return a JSONL file to download. In API version 2026-01 and later an app can run up to five bulk queries per store at the same time, and the query Shopify runs in the background does not count against the rate limit.[6]

Versions. Shopify releases a new API version every three months, named by date, such as 2026-04. Each stable version is supported for at least 12 months, and if a request names a version that is no longer supported, Shopify falls forward to the oldest supported stable version.[7] That fall-forward is where integrations break quietly. Our post on Shopify API versioning lessons from five case studies shows what that looks like in practice.

Example: syncing stock for 20,000 variants from an ERP

Take a hypothetical store on a standard plan with 20,000 variants in one location. Its ERP sends stock levels every night, and the integration has to write all of them to Shopify.

REST Admin API (legacy)GraphQL Admin API
Calls needed20,000, one per inventory level20,000 ÷ 250 = 80 mutations
Limit2 requests per second[3]100 points per second, 10 points per mutation[4]
Minimum time20,000 ÷ 2 = 10,000 s, about 2 h 47 min80 × 10 = 800 points, about 8 s of budget

The GraphQL version sends one mutation with 250 quantities, the maximum array size[5], and repeats it 80 times. At the default mutation cost the whole sync uses 800 points, which a standard plan refills in eight seconds.[4] The REST version needs one call per inventory level and is limited by the request rate, not by the work. On Plus the REST rate is 10 times higher[3], which still leaves the sync at about 17 minutes. This is why we rebuild REST integrations in GraphQL during an ERP integration project instead of only raising the limits.

GraphQL Admin API vs REST Admin API

GraphQL Admin APIREST Admin API
StatusCurrent; required for new public apps since April 1, 2025Legacy since October 1, 2024[3]
EndpointOne endpoint, you choose the fieldsOne endpoint per resource, fixed responses
Rate limitCost points per second, by plan[4]Bucket of 40 requests, refilling at 2 per second; 10 times higher on Plus[3]
Large exportsBulk operations to a JSONL file[6]Paging through results

FAQ

Is the Shopify REST Admin API deprecated?

It is legacy, not switched off. Shopify made it a legacy API on October 1, 2024, and since April 1, 2025 new public apps must use only the GraphQL Admin API.[3]

What are the Shopify Admin API rate limits?

The GraphQL Admin API allows 100 cost points per second on standard plans, 200 on Advanced, 1,000 on Plus and 2,000 on enterprise, with a maximum of 1,000 points for any single query.[4]

How often does the Admin API version change?

Every three months. Each stable version is supported for at least 12 months, and requests to an unsupported version are answered by the oldest supported stable version.[7]

How do I get an Admin API access token?

Create a custom app for your store in the Dev Dashboard, set its API access and install it. Custom apps created in the Shopify admin before January 1, 2026 are legacy apps you can still manage there.[8]

Can the Admin API be used from a storefront?

No. An Admin API token can change store data, so it must stay on a server. Storefronts, mobile apps and headless frontends use the Storefront API instead.

The bottom line

The Shopify Admin API is how apps and integrations read and change store data, and today that means the GraphQL Admin API, with REST kept only as legacy. It is limited by cost points per second, which rise with the plan, and it changes version every quarter. Build on GraphQL, batch your writes, use bulk operations for large exports and keep the version up to date. When an integration needs more than an app can give, our custom app team builds it on the Admin API.

Article sources

We use primary sources only: official documentation, product pages and laws. Each link was checked on the date shown.

  1. Shopify Dev. GraphQL Admin API reference. Accessed 17th Nov 2026.
  2. Shopify Dev. Access scopes. Accessed 17th Nov 2026.
  3. Shopify Dev. REST Admin API reference. Accessed 17th Nov 2026.
  4. Shopify Dev. GraphQL Admin API rate limits. Accessed 17th Nov 2026.
  5. Shopify Dev. Shopify API limits. Accessed 17th Nov 2026.
  6. Shopify Dev. Perform bulk operations with the GraphQL Admin API. Accessed 17th Nov 2026.
  7. Shopify Dev. API versioning. Accessed 17th Nov 2026.
  8. Shopify Help Center. Custom apps. Accessed 17th Nov 2026.

Need this on your store?

See the service

The checklist we run before touching a client's code

Get it by email, plus a few short notes over the next two weeks: what we see most often on Shopify stores and what actually fixes it.

No spam. Unsubscribe anytime. Privacy Policy