Create Live Items | Webflow Developer Documentation

curl -X POST "https://api.webflow.com/beta/collections/580e63fc8c9a982ac9b8b745/items/live?skipInvalidFiles=true" \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "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"
    }
  }
}'

{
  "id": "42b720ef280c7a7a3be8cabe",
  "lastPublished": "2022-11-29T16:22:43.159Z",
  "lastUpdated": "2022-11-17T17:19:43.282Z",
  "createdOn": "2022-11-17T17:11:57.148Z",
  "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"
    }
  },
  "cmsLocaleId": "653ad57de882f528b32e810e",
  "isArchived": false,
  "isDraft": false
}

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 item(s) in a collection that will be immediately published to the live site.

This endpoint accepts two request shapes, and a request must use one or the other:

Single item — send fieldData at the top level. Set cmsLocaleId to create the item in a specific locale.
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.

{
  "items": [
    {
      "isArchived": false,
      "isDraft": false,
      "fieldData": {
        "name": "Senior Data Analyst",
        "slug": "senior-data-analyst"
      }
    },
    {
      "isArchived": false,
      "isDraft": false,
      "fieldData": {
        "name": "Product Manager",
        "slug": "product-manager"
      }
    }
  ]
}

A request that carries both fieldData and items returns a 400.

To create items across multiple locales, use Create Items, then Publish Items.

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 item(s) in a collection that will be immediately published to the live site. This endpoint accepts two request shapes, and a request must use one or the other: - **Single item** — send `fieldData` at the top level. Set `cmsLocaleId` to create the item in a specific locale. - **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. ```json { "items": [ { "isArchived": false, "isDraft": false, "fieldData": { "name": "Senior Data Analyst", "slug": "senior-data-analyst" } }, { "isArchived": false, "isDraft": false, "fieldData": { "name": "Product Manager", "slug": "product-manager" } } ] } ``` A request that carries both `fieldData` and `items` returns a `400`. To create items across multiple locales, use [Create Items](/data/v2.0.0-beta/reference/cms/collection-items/staged-items/create-items), then [Publish Items](/data/v2.0.0-beta/reference/cms/collection-items/staged-items/publish-item). 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

Details of the item(s) to create

Collection ItemobjectRequired

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.

Multiple Live ItemsobjectRequired

Response

Request was successful

idstringRead-only

Unique identifier for the Item

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

fieldDataobject

cmsLocaleIdstringOptional

Identifier for the locale of the CMS item

isArchivedbooleanOptionalDefaults to false

Boolean determining if the Item is set to archived

isDraftbooleanOptionalDefaults to false

Whether the item is in a draft state. Together with lastPublished, this determines the status shown in the Webflow UI. See Publishing with the CMS API for the full mapping.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error