---
title: "Create CMS item"
method: POST
path: "/api/v1/sites/{subdomain}/collections/{collectionId}/items"
tags: ["collections"]
---

# Create CMS item

`POST /api/v1/sites/{subdomain}/collections/{collectionId}/items`

## Request

- Base URL: `https://slatehut.com`
- URL: `https://slatehut.com/api/v1/sites/{subdomain}/collections/{collectionId}/items`
- Auth: HTTP bearer

## Request body

- CmsItemWriteRequest
  - `data` object, required
  - `status` 'draft' | 'published'

## Response `201`

- object
  - `item` CmsItem, required
    - `id` string, required
    - `collectionId` string, required
    - `subdomain` string, required
    - `slug` string, required
    - `data` object, required
    - `createdAt` integer, required
    - `updatedAt` integer, required
    - `status` 'draft' | 'published', required

## Other responses

- `409`: Validation or conflict error

---

[API](https://skmtc.dev/slatehut/apis/slatehut-api.md) · [All operations](https://skmtc.dev/slatehut/apis/slatehut-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slatehut/apis/slatehut-api/revisions/32dae277550c?raw)