Skip to main content
POST
Create Collection

Create Collection

Creates a new manual collection in the store. Products are added to the collection individually — automated (“smart”) rule-based collections are not supported.

Request

Body Parameters

title
string
required
The collection title
body_html
string
Collection description (supports HTML)
handle
string
URL-safe handle. Auto-generated from the title (lowercased, spaces → -) if not provided
image
string
Collection featured image URL

Response

Returns HTTP 201 with a bare Shopify-style object: the created collection under the collection key (the same Shopify-compatible shape returned by Get Collection). The response is not wrapped in a { status, data } envelope.
collection
object
The created collection (Shopify-compatible shape)

Example Response

Errors

Validation and other failures return a Shopify-style { errors } body with the appropriate HTTP status:
StatusDescription
401Invalid or missing access token
403App doesn’t have the write_products scope
400title is required / invalid request body