{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"<Tip title=\"Components in Rich Text\">\n  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.\n\n  Scalar props are `prop-<propId>=\"…\"` attributes on the `<wf-component>`. Text and rich-text props are nested `<wf-prop name=\"<propId>\" type=\"text|richtext\">…</wf-prop>` children.\n\n  A write is rejected with a `400` if a component can't be resolved, contains a Collection List, populates a Slot (a component with an unpopulated Slot is allowed), includes an unknown prop, or creates a new instance in a secondary locale.\n\n  `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.\n</Tip>\n\nCreate Item(s) in a Collection.\n\nThis endpoint accepts two request shapes, and a request must use one or the other:\n\n- **Single item** — send `fieldData` at the top level. Set `cmsLocaleId` to create the item in a specific locale.\n- **Multiple items** — send an `items` array with at least one entry. Each entry needs its own `fieldData`, and can set its own `cmsLocaleId`, `isDraft`, and `isArchived`. The API ignores any other property on an entry.\n\n```json\n{\n  \"items\": [\n    {\n      \"isArchived\": false,\n      \"isDraft\": false,\n      \"fieldData\": {\n        \"name\": \"Senior Data Analyst\",\n        \"slug\": \"senior-data-analyst\"\n      }\n    },\n    {\n      \"isArchived\": false,\n      \"isDraft\": false,\n      \"fieldData\": {\n        \"name\": \"Product Manager\",\n        \"slug\": \"product-manager\"\n      }\n    }\n  ]\n}\n```\n\nA request that carries both `fieldData` and `items` returns a `400`.\n\nTo create items across multiple locales, please use [this endpoint.](/data/reference/cms/collection-items/staged-items/create-items)\n\nRequired scope | `CMS:write`\n","properties":{"path":{"type":"object","properties":{"collection_id":{"type":"string","examples":["580e63fc8c9a982ac9b8b745"],"description":"Unique identifier for a Collection"}},"required":["collection_id"],"additionalProperties":false},"query":{"type":"object","properties":{"skipInvalidFiles":{"type":"boolean","default":true,"examples":[true],"description":"When true, invalid files are skipped and processing continues. When false, the entire request fails if any file is invalid."}},"required":[],"additionalProperties":false},"body":{"oneOf":[{"title":"Single Item","description":"A Collection Item represents a single entry in your collection. Each item includes:\n\n- **System metadata** - Automatically managed fields like IDs and timestamp <br/>\n- **Status flags** - Controls for managing content state: `isDraft`, `isArchived `<br/>\n- **Content fields** - Stored in `fieldData`. Each item needs a `name` and `slug`, and may include additional fields matching your collection's schema definition.\n","type":"object","required":["fieldData"],"properties":{"cmsLocaleId":{"type":"string","description":"Identifier for the locale of the CMS item","examples":["653ad57de882f528b32e810e"]},"isArchived":{"type":"boolean","default":false,"description":"Boolean determining if the Item is in an archived state."},"isDraft":{"type":"boolean","default":true,"description":"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.\n","examples":[true]},"fieldData":{"type":"object","required":["name","slug"],"properties":{"name":{"type":"string","description":"Name of the Item"},"slug":{"type":"string","description":"URL structure of the Item in your site. Note: Updates to an item slug will break all links referencing the old slug."}},"additionalProperties":true,"examples":[{"date":"2022-11-18T00:00:00.000Z","featured":false,"name":"My new item","slug":"my-new-item","color":"#db4b68"}]}},"examples":[{"isArchived":false,"isDraft":false,"fieldData":{"name":"The Hitchhiker's Guide to the Galaxy","slug":"hitchhikers-guide-to-the-galaxy","plain-text":"Don't Panic.","rich-text":"<h3>A Guide to Interstellar Travel</h3><p>A towel is about the most massively useful thing an interstellar hitchhiker can have. <strong>Don't forget yours!</strong></p>","main-image":{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"},"image-gallery":[{"fileId":"62b720ef280c7a7a3be8cabd","url":"/files/62b720ef280c7a7a3be8cabd_image.png"},{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"}],"intro-video":"https://www.youtube.com/watch?v=aJ83KAggd-4","official-site":"https://hitchhikers.fandom.com/wiki/The_Hitchhiker%27s_Guide_to_the_Galaxy","contact-email":"zaphod.beeblebrox@heartofgold.gov","support-phone":"424-242-4242","answer-to-everything":42,"release-date":"1979-10-12T00:00:00.000Z","is-featured":true,"brand-color":"#000000","category":"62b720ef280c7a7a3be8cabf","author":"62b720ef280c7a7a3be8cab0","tags":["62b720ef280c7a7a3be8cab1","62b720ef280c7a7a3be8cab2"],"downloadable-asset":{"fileId":"62b720ef280c7a7a3be8cab3","url":"/files/62b720ef280c7a7a3be8cab3_document.pdf"}}}]},{"type":"object","title":"Multiple Items","additionalProperties":false,"properties":{"items":{"type":"array","minItems":1,"description":"The items to create. Each entry needs its own `fieldData`. Don't send a top-level `fieldData` with this shape.","items":{"description":"A Collection Item represents a single entry in your collection. Each item includes:\n\n- **System metadata** - Automatically managed fields like IDs and timestamp <br/>\n- **Status flags** - Controls for managing content state: `isDraft`, `isArchived `<br/>\n- **Content fields** - Stored in `fieldData`. Each item needs a `name` and `slug`, and may include additional fields matching your collection's schema definition.\n","type":"object","required":["fieldData"],"properties":{"cmsLocaleId":{"type":"string","description":"Identifier for the locale of the CMS item","examples":["653ad57de882f528b32e810e"]},"isArchived":{"type":"boolean","default":false,"description":"Boolean determining if the Item is in an archived state."},"isDraft":{"type":"boolean","default":true,"description":"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.\n","examples":[true]},"fieldData":{"type":"object","required":["name","slug"],"properties":{"name":{"type":"string","description":"Name of the Item"},"slug":{"type":"string","description":"URL structure of the Item in your site. Note: Updates to an item slug will break all links referencing the old slug."}},"additionalProperties":true,"examples":[{"date":"2022-11-18T00:00:00.000Z","featured":false,"name":"My new item","slug":"my-new-item","color":"#db4b68"}]}},"examples":[{"isArchived":false,"isDraft":false,"fieldData":{"name":"The Hitchhiker's Guide to the Galaxy","slug":"hitchhikers-guide-to-the-galaxy","plain-text":"Don't Panic.","rich-text":"<h3>A Guide to Interstellar Travel</h3><p>A towel is about the most massively useful thing an interstellar hitchhiker can have. <strong>Don't forget yours!</strong></p>","main-image":{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"},"image-gallery":[{"fileId":"62b720ef280c7a7a3be8cabd","url":"/files/62b720ef280c7a7a3be8cabd_image.png"},{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"}],"intro-video":"https://www.youtube.com/watch?v=aJ83KAggd-4","official-site":"https://hitchhikers.fandom.com/wiki/The_Hitchhiker%27s_Guide_to_the_Galaxy","contact-email":"zaphod.beeblebrox@heartofgold.gov","support-phone":"424-242-4242","answer-to-everything":42,"release-date":"1979-10-12T00:00:00.000Z","is-featured":true,"brand-color":"#000000","category":"62b720ef280c7a7a3be8cabf","author":"62b720ef280c7a7a3be8cab0","tags":["62b720ef280c7a7a3be8cab1","62b720ef280c7a7a3be8cab2"],"downloadable-asset":{"fileId":"62b720ef280c7a7a3be8cab3","url":"/files/62b720ef280c7a7a3be8cab3_document.pdf"}}}]}}}}],"examples":[{"isArchived":false,"isDraft":false,"fieldData":{"name":"The Hitchhiker's Guide to the Galaxy","slug":"hitchhikers-guide-to-the-galaxy","plain-text":"Don't Panic.","rich-text":"<h3>A Guide to Interstellar Travel</h3><p>A towel is about the most massively useful thing an interstellar hitchhiker can have. <strong>Don't forget yours!</strong></p>","main-image":{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"},"image-gallery":[{"fileId":"62b720ef280c7a7a3be8cabd","url":"/files/62b720ef280c7a7a3be8cabd_image.png"},{"fileId":"62b720ef280c7a7a3be8cabe","url":"/files/62b720ef280c7a7a3be8cabe_image.png"}],"intro-video":"https://www.youtube.com/watch?v=aJ83KAggd-4","official-site":"https://hitchhikers.fandom.com/wiki/The_Hitchhiker%27s_Guide_to_the_Galaxy","contact-email":"zaphod.beeblebrox@heartofgold.gov","support-phone":"424-242-4242","answer-to-everything":42,"release-date":"1979-10-12T00:00:00.000Z","is-featured":true,"brand-color":"#000000","category":"62b720ef280c7a7a3be8cabf","author":"62b720ef280c7a7a3be8cab0","tags":["62b720ef280c7a7a3be8cab1","62b720ef280c7a7a3be8cab2"],"downloadable-asset":{"fileId":"62b720ef280c7a7a3be8cab3","url":"/files/62b720ef280c7a7a3be8cab3_document.pdf"}}}]}},"required":["path"],"additionalProperties":false},"name":"Create Collection Item(s)","id":"webflow.create-item","example":{"path":{"collection_id":"580e63fc8c9a982ac9b8b745"}},"maxRequests":1,"summary":false}}