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

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

Response

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

Example Response

Errors

Validation and other failures return a standard { errors } body with the appropriate HTTP status: