🔒
Requires write_collection access scope. More access scope

The Create Collection API allows users to create a new collection in the store, including details like the title, description, associated products, SEO attributes, and merchandise sorting rules. This endpoint provides flexibility for managing collections and organizing products effectively.This API is especially useful for:

Create a collection to group related products for better categorization.
Apply specific sorting rules to arrange products in the collection.

Request Parameters

Public Request Parameters

📘
Public Request Parameters

Body Parameters

Parameter	Type	Required	Description	Example
`collection`	object	Yes	The collection configuration object	`{...}`
`collection.title`	string	Yes	The name of the collection	`Summer Sale 2023`
`collection.handle`	string	No	A unique URL-friendly identifier for the collection	`summer-sale-2023`
`collection.description`	string	No	The description of the collection	`Discounted summer products`
`collection.image`	object	No	Image details for the collection	`{...}`
`collection.seo_title`	string	No	The SEO title for the collection	`Summer Sale Collection`
`collection.seo_keywords`	array of strings	No	The keywords for SEO	`["summer", "sale", "2023"]`
`collection.seo_description`	string	No	The SEO description for the collection	`Discounted summer products collection`
`collection.sort_order`	string	No	Merchandise sorting rules. Options include: manual (default), sales-desc, price-asc, price-desc, views-desc, vendor-asc, vendor-desc, created-desc, and more	`price-asc`
`collection.product_ids`	array of strings	No	List of product IDs to include in the collection. Must be valid UUIDs	`["prod_123", "prod_456"]`

Image Object Structure

Parameter	Type	Required	Description	Example
`src`	string	Yes	The source URL of the collection image	`https://example.com/summer.jpg`
`width`	int32	No	The width of the collection image in pixels	`800`
`height`	int32	No	The height of the collection image in pixels	`600`
`alt`	string	No	Alt text for the collection image	`Summer collection image`

Response Explanation

Public Response Parameters

📘
Public Response Parameters

Successful Response

Parameter	Type	Example	Description
`code`	string	`200`	Error code (200 indicates success)
`message`	string	`Success`	Error message
`data`	object	`{...}`	Contains the collects data
`data.collection`	collection object	`{...}`	collection object

Collection Object Structure

Parameter	Type	Example	Description
`id`	string	`coll_123456`	Unique identifier of the collection
`title`	string	`Summer Collection`	Name of the collection
`description`	string	`Our best summer products`	Description of the collection
`handle`	string	`summer-collection`	URL-friendly identifier
`smart`	boolean	`false`	Whether this is a smart collection (dynamically filtered)
`image`	object	`{...}`	Image details for the collection
`seo_title`	string	`Summer Collection 2023`	SEO-optimized title
`seo_keywords`	array of strings	`["summer", "2023", "sale"]`	SEO keywords for the collection
`seo_description`	string	`Discount on summer products`	SEO description
`sort_order`	string	`manual`	How products are sorted in this collection
`created_at`	string	`2023-06-20T15:30:00Z`	Timestamp when the collection was created
`updated_at`	string	`2023-06-21T09:15:00Z`	Timestamp when the collection was last updated

Image Object Structure

Parameter	Type	Example	Description
`src`	string	`https://example.com/image.jpg`	URL of the collection image
`width`	int32	`800`	Image width in pixels
`height`	int32	`600`	Image height in pixels
`alt`	string	`Summer products`	Alternative text for the image

Error Response

Field	Type	Example	Description
`code`	string	`InvalidParameter`	Error http message
`message`	string	``	Error message

API Structure Overview