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 Custom API

The Custom API from Shopify — 24 operation(s) for custom.

Shopify Custom 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 Custom. 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 42 operations across 24 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.

42 operations 24 paths 0 schemas 6 DELETE18 GET12 POST6 PUT

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 Custom 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 42

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

Custom 42
POST
/admin/api/2020-01/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202001_create_collects body → 200
POST
/admin/api/2020-04/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202004_create_collects body → 200
POST
/admin/api/2020-07/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202007_create_collects body → 200
POST
/admin/api/2020-10/collects.json
Shopify Adds A Product To A Custom Collection
create_collects body → 200
POST
/admin/api/2021-01/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_202101_create_collects body → 200
POST
/admin/api/unstable/collects.json
Shopify Adds A Product To A Custom Collection
deprecated_unstable_create_collects body → 200
GET
/admin/api/2020-01/custom_collections.json
Shopify Retrieves A List Of Custom Collections
deprecated_202001_get_custom_collections 12 params → 200
POST
/admin/api/2020-01/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202001_create_custom_collections body → 200
GET
/admin/api/2020-01/custom_collections/count.json
Shopify Retrieves A Count Of Custom Collections
deprecated_202001_get_custom_collections_count 7 params → 200
GET
/admin/api/2020-01/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202001_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-01/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202001_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-01/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202001_delete_custom_collections_param_custom_collection_id 1 param → 200
GET
/admin/api/2020-04/custom_collections.json
Shopify Retrieves A List Of Custom Collections
deprecated_202004_get_custom_collections 12 params → 200
POST
/admin/api/2020-04/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202004_create_custom_collections body → 200
GET
/admin/api/2020-04/custom_collections/count.json
Shopify Retrieves A Count Of Custom Collections
deprecated_202004_get_custom_collections_count 7 params → 200
GET
/admin/api/2020-04/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202004_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-04/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202004_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-04/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202004_delete_custom_collections_param_custom_collection_id 1 param → 200
GET
/admin/api/2020-07/custom_collections.json
Shopify Retrieves A List Of Custom Collections
deprecated_202007_get_custom_collections 12 params → 200
POST
/admin/api/2020-07/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202007_create_custom_collections body → 200
GET
/admin/api/2020-07/custom_collections/count.json
Shopify Retrieves A Count Of Custom Collections
deprecated_202007_get_custom_collections_count 7 params → 200
GET
/admin/api/2020-07/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202007_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-07/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202007_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-07/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202007_delete_custom_collections_param_custom_collection_id 1 param → 200
GET
/admin/api/2020-10/custom_collections.json
Shopify Retrieves A List Of Custom Collections
get_custom_collections 12 params → 200
POST
/admin/api/2020-10/custom_collections.json
Shopify Creates A Custom Collection
create_custom_collections body → 200
GET
/admin/api/2020-10/custom_collections/count.json
Shopify Retrieves A Count Of Custom Collections
get_custom_collections_count 7 params → 200
GET
/admin/api/2020-10/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2020-10/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2020-10/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
delete_custom_collections_param_custom_collection_id 1 param → 200
GET
/admin/api/2021-01/custom_collections.json
Shopify Retrieves A List Of Custom Collections
deprecated_202101_get_custom_collections 12 params → 200
POST
/admin/api/2021-01/custom_collections.json
Shopify Creates A Custom Collection
deprecated_202101_create_custom_collections body → 200
GET
/admin/api/2021-01/custom_collections/count.json
Shopify Retrieves A Count Of Custom Collections
deprecated_202101_get_custom_collections_count 7 params → 200
GET
/admin/api/2021-01/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_202101_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/2021-01/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_202101_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/2021-01/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_202101_delete_custom_collections_param_custom_collection_id 1 param → 200
GET
/admin/api/unstable/custom_collections.json
Shopify Retrieves A List Of Custom Collections
deprecated_unstable_get_custom_collections 12 params → 200
POST
/admin/api/unstable/custom_collections.json
Shopify Creates A Custom Collection
deprecated_unstable_create_custom_collections body → 200
GET
/admin/api/unstable/custom_collections/count.json
Shopify Retrieves A Count Of Custom Collections
deprecated_unstable_get_custom_collections_count 7 params → 200
GET
/admin/api/unstable/custom_collections/{custom_collection_id}.json
Shopify Retrieves A Single Custom Collection
deprecated_unstable_get_custom_collections_param_custom_collection_id 2 params → 200
PUT
/admin/api/unstable/custom_collections/{custom_collection_id}.json
Shopify Updates An Existing Custom Collection
deprecated_unstable_update_custom_collections_param_custom_collection_id 1 param body → 200
DELETE
/admin/api/unstable/custom_collections/{custom_collection_id}.json
Shopify Deletes A Custom Collection
deprecated_unstable_delete_custom_collections_param_custom_collection_id 1 param → 200

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

shopify-custom-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 Custom 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.