How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Shopify Subscriptions API

The Subscriptions API from Shopify — 18 operation(s) for subscriptions.

Shopify Subscriptions API is one of 213 APIs that Shopify publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 8 JSON Schema definitions.

Tagged areas include Subscription. The published artifact set on APIs.io includes an OpenAPI specification, a JSON-LD context, API documentation, an API reference, and 8 JSON Schemas.

This API exposes 24 operations across 18 paths. It is described by OpenAPI 3.2.0, at version 2025-01.

Requests are made against a single base URL, https://{store}.myshopify.com/admin/api/2025-01.

24 operations 18 paths 0 schemas 6 DELETE12 GET6 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2025-01
Server
https://{store}.myshopify.com/admin/api/2025-01
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

Shopify Subscriptions API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-Shopify-Access-Token (AccessToken). By default, every request must be authenticated.

  • AccessToken — Access token obtained via OAuth

Paths & Operations 24

Across 18 paths, the API surfaces 24 operations — 6 DELETE, 12 GET, 6 POST. Each is listed below with its method, path, parameters, and response codes.

Subscriptions 24
POST
/admin/api/2020-01/webhooks.json
Shopify Create A New Webhook Subscription By Specifying Both An Address And A Topic
deprecated_202001_create_webhooks 1 param body → 200
GET
/admin/api/2020-01/webhooks/count.json
Shopify Retrieves A Count Of Existing Webhook Subscriptions
deprecated_202001_get_webhooks_count 2 params → 200
GET
/admin/api/2020-01/webhooks/{webhook_id}.json
Shopify Retrieves A Single Webhook Subscription
deprecated_202001_get_webhooks_param_webhook_id 2 params → 200
DELETE
/admin/api/2020-01/webhooks/{webhook_id}.json
Shopify Delete A Webhook Subscription
deprecated_202001_delete_webhooks_param_webhook_id 1 param → 200
POST
/admin/api/2020-04/webhooks.json
Shopify Create A New Webhook Subscription By Specifying Both An Address And A Topic
deprecated_202004_create_webhooks 1 param body → 200
GET
/admin/api/2020-04/webhooks/count.json
Shopify Retrieves A Count Of Existing Webhook Subscriptions
deprecated_202004_get_webhooks_count 2 params → 200
GET
/admin/api/2020-04/webhooks/{webhook_id}.json
Shopify Retrieves A Single Webhook Subscription
deprecated_202004_get_webhooks_param_webhook_id 2 params → 200
DELETE
/admin/api/2020-04/webhooks/{webhook_id}.json
Shopify Delete A Webhook Subscription
deprecated_202004_delete_webhooks_param_webhook_id 1 param → 200
POST
/admin/api/2020-07/webhooks.json
Shopify Create A New Webhook Subscription By Specifying Both An Address And A Topic
deprecated_202007_create_webhooks 1 param body → 200
GET
/admin/api/2020-07/webhooks/count.json
Shopify Retrieves A Count Of Existing Webhook Subscriptions
deprecated_202007_get_webhooks_count 2 params → 200
GET
/admin/api/2020-07/webhooks/{webhook_id}.json
Shopify Retrieves A Single Webhook Subscription
deprecated_202007_get_webhooks_param_webhook_id 2 params → 200
DELETE
/admin/api/2020-07/webhooks/{webhook_id}.json
Shopify Delete A Webhook Subscription
deprecated_202007_delete_webhooks_param_webhook_id 1 param → 200
POST
/admin/api/2020-10/webhooks.json
Shopify Create A New Webhook Subscription By Specifying Both An Address And A Topic
create_webhooks 1 param body → 200
GET
/admin/api/2020-10/webhooks/count.json
Shopify Retrieves A Count Of Existing Webhook Subscriptions
get_webhooks_count 2 params → 200
GET
/admin/api/2020-10/webhooks/{webhook_id}.json
Shopify Retrieves A Single Webhook Subscription
get_webhooks_param_webhook_id 2 params → 200
DELETE
/admin/api/2020-10/webhooks/{webhook_id}.json
Shopify Delete A Webhook Subscription
delete_webhooks_param_webhook_id 1 param → 200
POST
/admin/api/2021-01/webhooks.json
Shopify Create A New Webhook Subscription By Specifying Both An Address And A Topic
deprecated_202101_create_webhooks 1 param body → 200
GET
/admin/api/2021-01/webhooks/count.json
Shopify Retrieves A Count Of Existing Webhook Subscriptions
deprecated_202101_get_webhooks_count 2 params → 200
GET
/admin/api/2021-01/webhooks/{webhook_id}.json
Shopify Retrieves A Single Webhook Subscription
deprecated_202101_get_webhooks_param_webhook_id 2 params → 200
DELETE
/admin/api/2021-01/webhooks/{webhook_id}.json
Shopify Delete A Webhook Subscription
deprecated_202101_delete_webhooks_param_webhook_id 1 param → 200
POST
/admin/api/unstable/webhooks.json
Shopify Create A New Webhook Subscription By Specifying Both An Address And A Topic
deprecated_unstable_create_webhooks 1 param body → 200
GET
/admin/api/unstable/webhooks/count.json
Shopify Retrieves A Count Of Existing Webhook Subscriptions
deprecated_unstable_get_webhooks_count 2 params → 200
GET
/admin/api/unstable/webhooks/{webhook_id}.json
Shopify Retrieves A Single Webhook Subscription
deprecated_unstable_get_webhooks_param_webhook_id 2 params → 200
DELETE
/admin/api/unstable/webhooks/{webhook_id}.json
Shopify Delete A Webhook Subscription
deprecated_unstable_delete_webhooks_param_webhook_id 1 param → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

shopify-subscriptions-api-openapi.yml Raw ↑

Other APIs Shopify publishes across the network.

Shopify GraphQL Admin API
Shopify Storefront API
Shopify Customer Account API
Shopify Partner API
Shopify Payments Apps API
Shopify Liquid API
Shopify Functions API
Shopify Discount Function API
Shopify Webhooks API
Shopify App Bridge
Shopify App Home API
Shopify Checkout UI Extensions API
Where this information came from

This is an independent, third-party profile of Shopify Subscriptions API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.