Skip to navigation
CMSCollection ItemsStaged Items

POST /items/bulk

Use Create Items for new integrations

Use Create Items for new beta integrations. Creating collection items explains how to move from this endpoint.

Components in Rich Text

Rich Text field values can contain Webflow component instances as <wf-component> markup — see Components in Rich Text for the markup grammar, how to find component and property IDs, and the write constraints.

Create an item or multiple items in a CMS Collection across multiple corresponding locales.

Notes:

  • This endpoint can create up to 100 items in a request.
  • If the cmsLocaleIds parameter is undefined or empty and localization is enabled, items will only be created in the primary locale.

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

Request

Details of the item to create
cmsLocaleIdslist of stringsOptional
Array of identifiers for the locales where the item will be created
isArchivedbooleanOptionalDefaults to false
Indicates whether the item is archived.
isDraftbooleanOptionalDefaults to true

Whether the item is created in a draft state. A new item has never been published, so isDraft: true gives it a Draft status. Set isDraft: false to queue the item to publish on the next site publish.

fieldDataobject or list of objectsOptional

Response

Request was successful
idstringRead-only
Unique identifier for the Item
cmsLocaleIdslist of stringsOptional
Array of identifiers for the locales where the item will be created
lastPublishedstring or nullOptionalRead-onlyformat: "date-string"
The date the item was last published
lastUpdatedstringOptionalRead-onlyformat: "date-string"
The date the item was last updated
createdOnstringOptionalRead-onlyformat: "date-string"
The date the item was created
isArchivedbooleanOptionalDefaults to false
Boolean determining if the Item is set to archived
isDraftbooleanOptionalDefaults to true

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.

fieldDataobjectOptional

Errors

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