---
title: "Create a Collection"
method: POST
path: "/v3/collections"
tags: ["Collections"]
---

# Create a Collection

`POST /v3/collections`

## Request body

- CreateCollectionRequestV3 — Request to create a new collection
  - `collectionName` string, required — Unique name/path for the collection. Supports dot notation for hierarchical paths. - Only letters (a-z, A-Z), digits (0-9), underscores (_), and dots (.) are allowed - Each segment (between dots) must start with a letter or underscore (not a digit) - Segments cannot consist only of digits - Each segment must be 1-256 characters - No leading, trailing, or consecutive dots - Invalid names are rejected with a 400 Bad Request error **Valid Examples:** - 'product_catalog' - 'orders.line_items.sku' - 'customer_data' - 'price_v2' **Invalid Examples:** - 'product-catalog' (contains hyphen) - '123items' (starts with digit) - 'items..data' (consecutive dots) - 'order#123' (contains invalid character #)

## Response `200`

The request has succeeded.

- CollectionResponseV3 — Collection details
  - `collectionID` string, required — Unique identifier for the collection
  - `collectionName` string, required — The collection name/path. Only letters, digits, underscores, and dots are allowed.
  - `itemCount` integer, required — Number of items in the collection
  - `items` CollectionItemV3[] — List of items in the collection (when fetching collection details)
    - `collectionItemID` string, required — Unique identifier for the item
    - `data` union, required — The data stored in this item
      - string
      - object
    - `createdAt` string, date-time, required — When the item was created
    - `updatedAt` string, date-time, required — When the item was last updated
  - `page` integer — Current page number
  - `limit` integer — Number of items per page
  - `totalPages` integer — Total number of pages
  - `createdAt` string, date-time, required — When the collection was created
  - `updatedAt` string, date-time — When the collection was last updated

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)