Create Items | Webflow Developer Documentation

curl -X POST https://api.webflow.com/beta/collections/580e63fc8c9a982ac9b8b745/items/bulk \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "cmsLocaleIds": [
    "66f6e966c9e1dc700a857ca3",
    "66f6e966c9e1dc700a857ca4",
    "66f6e966c9e1dc700a857ca5"
  ],
  "isArchived": false,
  "isDraft": true,
  "fieldData": {
    "name": "Don’t Panic",
    "slug": "dont-panic"
  }
}'

{
  "id": "580e64008c9a982ac9b8b754",
  "items": [
    {
      "id": "66f6ed9576ddacf3149d5ea6",
      "cmsLocaleId": "66f6e966c9e1dc700a857ca3",
      "lastPublished": null,
      "lastUpdated": "2024-02-28T19:25:39.942Z",
      "createdOn": "2024-02-28T19:25:39.942Z",
      "isArchived": false,
      "isDraft": true,
      "fieldData": {
        "name": "Don't Panic",
        "slug": "dont-panic"
      }
    },
    {
      "id": "66f6ed9576ddacf3149d5ea6",
      "cmsLocaleId": "66f6e966c9e1dc700a857ca4",
      "lastPublished": null,
      "lastUpdated": "2024-02-28T19:25:39.942Z",
      "createdOn": "2024-02-28T19:25:39.942Z",
      "isArchived": false,
      "isDraft": true,
      "fieldData": {
        "name": "Don't Panic",
        "slug": "dont-panic"
      }
    },
    {
      "id": "66f6ed9576ddacf3149d5ea6",
      "cmsLocaleId": "66f6e966c9e1dc700a857ca5",
      "lastPublished": null,
      "lastUpdated": "2024-02-28T19:25:39.942Z",
      "createdOn": "2024-02-28T19:25:39.942Z",
      "isArchived": false,
      "isDraft": true,
      "fieldData": {
        "name": "Don't Panic",
        "slug": "dont-panic"
      }
    }
  ]
}

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

<Tip title="Components in Rich Text"> Rich Text field values can contain Webflow component instances as `<wf-component>` markup — see [Components in Rich Text](/data/docs/working-with-the-cms/components-in-rich-text) for the markup grammar, how to find component and property IDs, and the write constraints. </Tip> 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