Create Collection Item(s) | Webflow Developer Documentation

curl -X POST https://api.webflow.com/beta/collections/580e63fc8c9a982ac9b8b745/items \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "isArchived": false,
  "isDraft": true,
  "fieldData": {
    "name": "Pan Galactic Gargle Blaster Recipe",
    "slug": "pan-galactic-gargle-blaster",
    "date": "2022-11-18T00:00:00.000Z",
    "featured": true,
    "color": "#db4b68"
  }
}'

{
  "id": "42b720ef280c7a7a3be8cabe",
  "fieldData": {
    "name": "Pan Galactic Gargle Blaster Recipe",
    "slug": "pan-galactic-gargle-blaster",
    "color": "#db4b68",
    "date": "2022-11-18T00:00:00.000Z",
    "featured": true
  },
  "cmsLocaleId": "653ad57de882f528b32e810e",
  "lastUpdated": "2022-11-17T17:19:43.282Z",
  "createdOn": "2022-11-17T17:11:57.148Z",
  "isArchived": false,
  "isDraft": true
}

Components in Rich Text (beta)

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 type="text|richtext">…</wf-prop> children.

A write is rejected with a 400 if a component can’t be resolved, isn’t allowed in Rich Text (e.g. it contains a Slot or Collection List), 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.

Create Item(s) in a Collection.

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

Required scope | CMS:write

<Note title="Components in Rich Text (beta)"> 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 type="text|richtext">…</wf-prop>` children. A write is rejected with a `400` if a component can't be resolved, isn't allowed in Rich Text (e.g. it contains a Slot or Collection List), 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. </Note> Create Item(s) in a Collection. To create items across multiple locales, please use [this endpoint.](/data/v2.0.0-beta/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

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.
Components in Rich Text - Rich Text field values are HTML strings that may contain Webflow component instances as <wf-component> custom-element markup. On read, instances appear inline; on write, the same markup creates or updates the instance. Scalar props are prop-<propId>="…" attributes; text and rich-text props are nested <wf-prop name="<propId>" type="text|richtext">…</wf-prop> children. Available behind the components-in-Rich-Text beta. A write is rejected with 400 if a component can’t be resolved, isn’t allowed in Rich Text (e.g. contains a Slot or Collection List), includes an unknown prop, or attempts to create a new instance in a secondary locale.
component-id and each prop-<propId> are specific to your site’s component definition. To obtain them, list your site’s components with GET /v2/sites/{site_id}/components (and GET /v2/sites/{site_id}/components/{component_id}/properties for prop IDs), or GET an item that already contains the component and reuse the returned <wf-component> markup. Omit data-w-id when creating an instance (the server assigns it) and keep the returned data-w-id when updating one.

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