CMSCollection ItemsStaged Items

Create Items

<Tip title="Components in Rich Text"> Rich Text field values may contain Webflow component instances as `<wf-component>` markup. On read they appear inline in the field's HTML; on write, the same markup creates or updates the instance. Scalar props are `prop-<propId>="…"` attributes on the `<wf-component>`. Text and rich-text props are nested `<wf-prop name="<propId>" type="text|richtext">…</wf-prop>` children. A write is rejected with a `400` if a component can't be resolved, contains a Collection List, populates a Slot (a component with an unpopulated Slot is allowed), includes an unknown prop, or creates a new instance in a secondary locale. `component-id` and each `prop-<propId>` are specific to your site's component definition — obtain them by listing your site's components (`GET /v2/sites/{site_id}/components`, plus `/components/{component_id}/properties` for prop IDs) or by reading an item that already contains the component and reusing the returned markup. Omit `data-w-id` when creating an instance (the server assigns it); keep it when updating one. </Tip> Create Item(s) in a Collection. This endpoint accepts two request shapes, and a request must use one or the other: - **Single item** — send `fieldData` at the top level. Set `cmsLocaleId` to create the item in a specific locale. - **Multiple items** — send an `items` array with at least one entry. Each entry needs its own `fieldData`, and can set its own `cmsLocaleId`, `isDraft`, and `isArchived`. The API ignores any other property on an entry. ```json { "items": [ { "isArchived": false, "isDraft": false, "fieldData": { "name": "Senior Data Analyst", "slug": "senior-data-analyst" } }, { "isArchived": false, "isDraft": false, "fieldData": { "name": "Product Manager", "slug": "product-manager" } } ] } ``` A request that carries both `fieldData` and `items` returns a `400`. To create items across multiple locales, please use [this endpoint.](/data/reference/cms/collection-items/staged-items/create-items) Required scope | `CMS:write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

collection_idstringRequiredformat: "objectid"
Unique identifier for a Collection

Query parameters

skipInvalidFilesbooleanOptionalDefaults to true
When true, invalid files are skipped and processing continues. When false, the entire request fails if any file is invalid.

Request

Details of the item(s) to create

Single ItemobjectRequired

A Collection Item represents a single entry in your collection. Each item includes:

  • System metadata - Automatically managed fields like IDs and timestamp
  • Status flags - Controls for managing content state: isDraft, isArchived
  • Content fields - Stored in fieldData. Each item needs a name and slug, and may include additional fields matching your collection’s schema definition.
OR
Multiple ItemsobjectRequired

Response

Request was successful
idstringRead-only
Unique identifier for the Item
lastPublishedstringRead-onlyformat: "date-string"
The date the item was last published
lastUpdatedstringRead-onlyformat: "date-string"
The date the item was last updated
createdOnstringRead-onlyformat: "date-string"
The date the item was created
fieldDataobject
cmsLocaleIdstringOptional
Identifier for the locale of the CMS item
isArchivedbooleanOptionalDefaults to false
Boolean determining if the Item is set to archived
isDraftbooleanOptionalDefaults to false

Whether the item is in a draft state. Together with lastPublished, this determines the status shown in the Webflow UI. See Publishing with the CMS API for the full mapping.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
429
Too Many Requests Error
500
Internal Server Error