Create Localized Collection Item(s) | 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 (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 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

<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 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

Indicates whether the item is in draft state.

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

Boolean determining if the Item is set to draft

fieldDataobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error