Create collection

POST 
/openapi/2025-06/collections

Allows users to create a new collection in the store, including details like the title, description, associated products, SEO attributes, and merchandise sorting rules.

Request

application/json

Body

Bodyrequired

collection objectrequired

Collection

titlestringrequired

The name of the collection

handlestring

A unique URL-friendly identifier for the collection

descriptionstring

The description of the collection

image object

Image

srcstringrequired

The source URL of the collection image

widthint32

The width of the collection image in pixels

heightint32

The height of the collection image in pixels

altstring

Alt text for the collection image

seo_titlestring

The SEO title for the collection

seo_keywordsstring[]

The keywords for SEO

seo_descriptionstring

The SEO description for the collection

sort_orderstring

Merchandise sorting rules. Options include: manual (default), sales-desc, price-asc, price-desc, views-desc, vendor-asc, vendor-desc, intelligent, and more

Default value: manual

product_idsstring[]

List of product IDs to include in the collection. Must be valid UUIDs

Example

{
  "collection": {
    "title": "string",
    "handle": "string",
    "description": "string",
    "image": {
      "src": "string",
      "width": 0,
      "height": 0,
      "alt": "string"
    },
    "seo_title": "string",
    "seo_keywords": [
      "string"
    ],
    "seo_description": "string",
    "sort_order": "manual",
    "product_ids": [
      "string"
    ]
  }
}

Responses

200

OK

application/json

Schema

Schema

codestring

error code

messagestring

error message

data object

collection object

Collection

idstring

Collection ID

titlestring

Title

descriptionstring

Description

handlestring

URL-friendly identifier (handle)

smartboolean

Smart

image object

Image

srcstring

Image source URL

widthint32

Width dimension

heightint32

Height dimension

altstring

Alt text for image

seo_titlestring

SEO title

seo_keywordsstring[]

SEO keywords

seo_descriptionstring

SEO description

sort_orderstring

Sort order

created_atstring

Creation timestamp, in ISO-8601 format

updated_atstring

Last update timestamp, in ISO-8601 format

Example

{
  "code": "string",
  "message": "string",
  "data": {
    "collection": {
      "id": "string",
      "title": "string",
      "description": "string",
      "handle": "string",
      "smart": true,
      "image": {
        "src": "string",
        "width": 0,
        "height": 0,
        "alt": "string"
      },
      "seo_title": "string",
      "seo_keywords": [
        "string"
      ],
      "seo_description": "string",
      "sort_order": "string",
      "created_at": "string",
      "updated_at": "string"
    }
  }
}