Create Localized Collection Item(s)

POST

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

Path parameters

collection_idstringRequired

Unique identifier for a Collection

Request

This endpoint expects an object.

fieldDataobject or list of objectsRequired

cmsLocaleIdslist of stringsOptional

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

isArchivedbooleanOptional

Indicates whether the item is archived.

isDraftbooleanOptional

Indicates whether the item is in draft state.

Response

Request was successful

idstring

Unique identifier for the Item

cmsLocaleIdslist of stringsOptional

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

lastPublishedstringOptional

The date the item was last published

lastUpdatedstringOptional

The date the item was last updated

createdOnstringOptional

The date the item was created

isArchivedbooleanOptional

Boolean determining if the Item is set to archived

isDraftbooleanOptional

Boolean determining if the Item is set to draft

fieldDataobjectOptional

Errors

POST

1 curl -X POST https://api.webflow.com/v2/collections/580e63fc8c9a982ac9b8b745/items/bulk \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "fieldData": {
6     "name": "Don’t Panic",
7     "slug": "dont-panic"
8   },
9   "cmsLocaleIds": [
10     "66f6e966c9e1dc700a857ca3",
11     "66f6e966c9e1dc700a857ca4",
12     "66f6e966c9e1dc700a857ca5"
13   ],
14   "isArchived": false,
15   "isDraft": false
16 }'

1 {
2   "id": "580e64008c9a982ac9b8b754",
3   "cmsLocaleIds": [
4     "653ad57de882f528b32e810e",
5     "6514390aea353fc691d69827",
6     "65143930ea353fc691d69cd8"
7   ],
8   "lastPublished": "2023-03-17T18:47:35.560Z",
9   "lastUpdated": "2023-03-17T18:47:35.560Z",
10   "createdOn": "2023-03-17T18:47:35.560Z",
11   "isArchived": true,
12   "isDraft": true,
13   "fieldData": {
14     "name": "My new item",
15     "slug": "my-new-item"
16   }
17 }

Update Single Collection Item

Up Next

Built with

1	curl -X POST https://api.webflow.com/v2/collections/580e63fc8c9a982ac9b8b745/items/bulk \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"fieldData": {
6	"name": "Don’t Panic",
7	"slug": "dont-panic"
8	},
9	"cmsLocaleIds": [
10	"66f6e966c9e1dc700a857ca3",
11	"66f6e966c9e1dc700a857ca4",
12	"66f6e966c9e1dc700a857ca5"
13	],
14	"isArchived": false,
15	"isDraft": false
16	}'

1	{
2	"id": "580e64008c9a982ac9b8b754",
3	"cmsLocaleIds": [
4	"653ad57de882f528b32e810e",
5	"6514390aea353fc691d69827",
6	"65143930ea353fc691d69cd8"
7	],
8	"lastPublished": "2023-03-17T18:47:35.560Z",
9	"lastUpdated": "2023-03-17T18:47:35.560Z",
10	"createdOn": "2023-03-17T18:47:35.560Z",
11	"isArchived": true,
12	"isDraft": true,
13	"fieldData": {
14	"name": "My new item",
15	"slug": "my-new-item"
16	}
17	}