Create Collection Items

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.

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 false

Indicates whether the item is in draft state.

fieldDataobject or list of objectsOptional

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

isArchivedbooleanOptionalDefaults to false

Boolean determining if the Item is set to archived

isDraftbooleanOptionalDefaults to false

Boolean determining if the Item is set to draft

fieldDataobjectOptional

Errors

POST

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

Up Next

Built with

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