POST /items/bulk | Webflow Developer Documentation

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

{
  "id": "580e64008c9a982ac9b8b754",
  "cmsLocaleIds": [
    "653ad57de882f528b32e810e",
    "6514390aea353fc691d69827",
    "65143930ea353fc691d69cd8"
  ],
  "lastPublished": "2023-03-17T18:47:35.560Z",
  "lastUpdated": "2023-03-17T18:47:35.560Z",
  "createdOn": "2023-03-17T18:47:35.560Z",
  "isArchived": false,
  "isDraft": true,
  "fieldData": {
    "name": "My new item",
    "slug": "my-new-item",
    "date": "2022-11-18T00:00:00.000Z",
    "featured": false,
    "color": "#db4b68"
  },
  "items": [
    {
      "id": "66f6ed9576ddacf3149d5ea6",
      "lastPublished": "2024-02-28T19:25:39.942Z",
      "lastUpdated": "2024-02-28T19:25:39.942Z",
      "createdOn": "2024-02-28T19:25:39.942Z",
      "cmsLocaleId": "66f6e966c9e1dc700a857ca3",
      "isArchived": false,
      "isDraft": false,
      "fieldData": {
        "name": "Don't Panic",
        "slug": "dont-panic"
      }
    },
    {
      "id": "66f6ed9576ddacf3149d5ea6",
      "lastPublished": "2024-02-28T19:25:39.942Z",
      "lastUpdated": "2024-02-28T19:25:39.942Z",
      "createdOn": "2024-02-28T19:25:39.942Z",
      "cmsLocaleId": "66f6e966c9e1dc700a857ca4",
      "isArchived": false,
      "isDraft": false,
      "fieldData": {
        "name": "Don't Panic",
        "slug": "dont-panic"
      }
    },
    {
      "id": "66f6ed9576ddacf3149d5ea6",
      "lastPublished": "2024-02-28T19:25:39.942Z",
      "lastUpdated": "2024-02-28T19:25:39.942Z",
      "createdOn": "2024-02-28T19:25:39.942Z",
      "cmsLocaleId": "66f6e966c9e1dc700a857ca5",
      "isArchived": false,
      "isDraft": false,
      "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.

Use Create Items for new integrations

This endpoint remains supported. New integrations should use Create Items, which does everything this endpoint does and can also add locale variants to an existing item. This guide to creating items shows how the request shape maps.

This endpoint can create up to 100 items in a request.
If the cmsLocaleIds parameter is not included in the request, an item 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. <Note title="Use Create Items for new integrations"> This endpoint remains supported. New integrations should use [Create Items](/data/reference/cms/collection-items/staged-items/create-items), which does everything this endpoint does and can also add locale variants to an existing item. [This guide to creating items](/data/docs/working-with-the-cms/create-items) shows how the request shape maps. </Note> <Note> - This endpoint can create up to 100 items in a request. - If the `cmsLocaleIds` parameter is not included in the request, an item will only be created in the primary locale. </Note> 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

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.

A Collection Item represents a single entry in your collection. Each item includes: - **System metadata** - Automatically managed fields like IDs and timestamp <br/> - **Status flags** - Controls for managing content state: `isDraft`, `isArchived `<br/> - **Content fields** - Stored in `fieldData`. Each item needs a `name` and `slug`, and may include additional fields matching your collection's schema definition.

fieldDataobject or list of objectsRequired

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

Indicates whether the item is in draft state.

Response

Request was successful

idstring

Unique identifier for the Item

cmsLocaleIdslist of strings

Array of identifiers for the locales where the item will be created

lastPublishedstring or nullRead-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

isDraftboolean

Whether the item is in a draft state. true unless the request set isDraft: false.

fieldDataobject

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error

Components in Rich Text

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

Use Create Items for new integrations

This endpoint can create up to 100 items in a request.
If the cmsLocaleIds parameter is not included in the request, an item will only be created in the primary locale.

Required scope | CMS:write