CMSCollection ItemsStaged Items

Create Collection Item(s)

Create Item(s) in a Collection.

To create items across multiple locales, please use this endpoint.

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(s) to create

Single ItemobjectRequired

A new Collection Item that will be created in the draft state.

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
fieldDataobject
cmsLocaleIdstring
Identifier for the locale of the CMS 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
isArchivedbooleanDefaults to false
Boolean determining if the Item is set to archived
isDraftbooleanDefaults to true
Boolean determining if the Item is set to draft

Errors

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