For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Resources
Get started
ReferenceGuidesExamplesChangelog
ReferenceGuidesExamplesChangelog
  • Data API
    • Introduction
  • Token
    • GETGet Authorization User Info
    • GETGet Authorization Info
  • Sites
    • GETList Sites
    • GETGet Site
    • GETGet Custom Domains
    • POSTPublish Site
  • Pages and Components
  • CMS
  • Forms
  • Custom Code
  • Assets
  • Comments
    • GETList Comment Threads
    • GETGet Comment Thread
    • GETList Comment Replies
  • Ecommerce
  • Webhooks
    • GETList Webhooks
    • GETGet Webhook
    • POSTCreate Webhook
    • DELRemove Webhook
  • Site Configuration
  • Enterprise
LogoLogo
Resources
Get started

Webflow CMS API

Manage your Webflow CMS content using the Data API
Was this page helpful?
Previous

List Collections

Next
Built with

Webflow’s CMS API lets you programmatically create, manage, and publish content. Use it to build custom workflows, integrate with external systems, and automate content management. For general information on the Webflow CMS, see the help center documentation.

Overview

Use the Data API to manage three core components of the Webflow CMS:

Collections

Database-like containers that define content structure and fields.

Fields

Individual data fields that define content types within a collection.

Items

Content records stored within a collection.

The API supports both staged and live content, giving you precise control over your publishing workflow. You can create content programmatically, perform bulk updates, and manage multi-locale content.


Workflows

There are a few workflows that are particularly helpful to understand when working with the CMS API.

Collection Management

Learn how to create, manage, and publish collections and items.

Publishing

Learn how items are published, updated, and unpublished.

Localization

Learn how to create and manage linked CMS items across multiple locales.

Content Delivery

Learn how to deliver cached content to external applications.


Key concepts

Collections

Collections are structured containers for dynamic content, similar to database tables. Each collection defines a content type, like blog posts, team members, or testimonials, by specifying a set of fields.

Collections can contain various field types, including text, rich text, images, dates, numbers, and references to other collections.

Each collection has a unique ID used to manage its details, fields, and items.

Collections endpoints

EndpointDescription
GET List collectionsRetrieve all collections for a site.
GET Get collectionRetrieve the schema and details for a specific collection.
POST Create collectionCreate a new collection.
DELETE Delete collectionRemove a collection and all of its items.

Collection fields

Fields define the structure and data type for content in a collection. Each field has a unique ID used to manage its details and item data. Each field’s type determines the kind of content it can store. See the field types reference for a full list of types and their properties.

Collection fields endpoints

EndpointDescription
POST Create fieldCreate a new field in a collection.
PATCH Update fieldModify an existing field.
DELETE Delete fieldRemove a field from a collection.
List fields

To list fields, retrieve collection details using the get collection endpoint.

Collection items

Items are individual records within a collection. Each item has a unique ID and contains data for the fields defined in that collection.

Collection Item states

Items exist in two main states:

Staged

Draft content not visible on your live site.

Live

Published content that appears on your website.

This dual-state system lets you prepare content changes without affecting your live site. You can create, edit, and preview staged content before publishing. For more details, see the CMS publishing guide.

Collection items endpoints

Staged
Live

Manage staged items on a site. These endpoints also work with live items. Updating a live item automatically updates its staged version. Creating a new item with these endpoints always creates a draft.

EndpointDescription
GET List itemsRetrieve a list of all items in a collection.
GET Get itemRetrieve a specific item.
POST Create item(s)Create items. Use cmsLocaleIds to create items across multiple locales.
PATCH Update itemsModify one or more items.
DELETE Delete itemsDelete one or more items.
POST Publish itemPublish one or more items.
Unpublish items

Use the unpublish live item endpoint to unpublish a live item.


Start working with the CMS API

Below is an interactive tutorial that will walk you through the basic steps of getting a collection, listing a collection schema, listing collection items, and creating a collection item.

Bulk operations

For most CMS operations, the API provides both single-item and bulk endpoints. Bulk endpoints allow you to perform CRUD operations (Create, Read, Update, Delete) on multiple items in a single API call, which is more efficient for managing content at scale.

To keep the sidebar clean, we’ve hidden most single-item endpoints. However, they are fully functional and not deprecated. The tables below show both the visible and hidden endpoints for staged and live collection items.

Staged Items
OperationSingle Item EndpointBulk Endpoint
ListGET /collections/{collection_id}/itemsN/A
GetGET /collections/{collection_id}/items/{item_id}N/A
CreatePOST /collections/{collection_id}/itemsPOST /collections/{collection_id}/items/bulk
UpdatePATCH /collections/{collection_id}/items/{item_id}PATCH /collections/{collection_id}/items
DeleteDELETE /collections/{collection_id}/items/{item_id}DELETE /collections/{collection_id}/items
PublishN/APOST /collections/{collection_id}/items/publish
Live Items
OperationSingle Item EndpointBulk Endpoint
ListGET /collections/{collection_id}/items/liveN/A
GetGET /collections/{collection_id}/items/{item_id}/liveN/A
CreatePOST /collections/{collection_id}/items/liveN/A
UpdatePATCH /collections/{collection_id}/items/{item_id}/livePATCH /collections/{collection_id}/items/live
UnpublishDELETE /collections/{collection_id}/items/{item_id}/liveDELETE /collections/{collection_id}/items/live

Webhooks

Use webhooks to receive real-time notifications about changes to your content. This enables automated workflows and integrations with other systems.

Webhook events

Create a webhook and subscribe to the following events for a given collection:

  • Collection item created
  • Collection item updated
  • Collection item deleted
  • Collection item published
  • Collection item un-published

Next Steps

Getting started

Create a collection, add fields, and create items. Includes pagination examples.

Working with webhooks

Set up real-time notifications for content changes to build automated workflows.