---
title: "Add new items to a Collection"
method: POST
path: "/v3/collections/items"
tags: ["Collections"]
---

# Add new items to a Collection

`POST /v3/collections/items`

## Request body

- AddCollectionItemsRequestV3 — Request to add new items to a collection
  - `collectionName` string, required — The name/path of the collection. Must use only letters, digits, underscores, and dots. Each segment must start with a letter or underscore.
  - `items` CollectionItemInputV3[], required — Array of items to add (maximum 100 items per request)
    - `data` union, required — The data to be embedded and stored (string or JSON object)
      - string
      - object

## Response `200`

The request has succeeded.

- AddCollectionItemsResponseV3 — Response after queuing items for async processing
  - `status` 'pending', required — Processing status
  - `message` string, required — Status message
  - `eventID` string, required — Event ID for tracking this operation. Use this to correlate with webhook notifications.
  - `addedCount` integer — Number of new items added (only present in synchronous mode, deprecated)
  - `items` CollectionItemV3[] — Array of items that were added (only present in synchronous mode, deprecated)
    - `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

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `404` — The server cannot find the requested resource.
- `500` — Server error

## Changes

- **2026-04-23** `2f50678734db` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bem-team/apis/bem-api/changes/v3/collections/items/post.md)

---

[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)