---
title: "Create Collection"
method: POST
path: "/v3/catalogcollection"
---

# Create Collection

`POST /v3/catalogcollection`

## Query parameters

- `id` string, required
- `echo` boolean

## Request body

- object
  - `name` string, required — Collection Name
  - `catalogId` integer, required
  - `description` string — Collection Description
  - `merchantId` integer — Merchant Id
  - `products` object[] — Can only be used if you have existing products
    - `id` integer — Product id
    - `name` string — name of the product
    - `clientNumber` integer — Client number
    - `description` string — description of the product
    - `active` boolean — Product is active or not
    - `minPrice` string — Minimum price of the product
    - `maxPrice` string — Maximum price of the product

## Response `201`

201

- object
  - `id` integer
  - `catalogId` integer
  - `name` string
  - `description` string
  - `created` string
  - `isAutomatic` boolean
  - `isFeatured` boolean
  - `modified` string
  - `productCount` integer

## Other responses

- `400` — 400

---

[API](https://skmtc.net/mxmerchant/apis/checkout-api.md) · [All operations](https://skmtc.net/mxmerchant/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mxmerchant/checkout-api/revisions/6807b698abcb/schema)