> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/webflow.md).

# Webflow

Manage CMS collections, items, and publishing for Webflow sites via the Webflow Data API v2.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication |
| --------- | -------------- |
| Webflow   | Site API Token |

### Webflow

Connect to Webflow to manage CMS collections, items, and publish your site via the Webflow Data API v2.

#### Set up in Webflow

1. As a site admin, open the site in Webflow and click the gear icon to open Site settings.
2. Click Generate API token, name it, choose the scopes your workflow needs (CMS read/write, publishing), and generate it.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Webflow**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field  | Required | What to enter                                                                                                                                                                                                                                                                                                                                              |
| -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Site API Token | Yes      | Your Webflow Site API token. Must be a Site token (Site Settings > Apps & Integrations > API access), NOT a Workspace token — Workspace tokens start with 'ws-' and do not grant CMS/Sites scopes. Required scopes: cms:read, cms:write, sites:read, sites:write. [Provider instructions](https://university.webflow.com/lesson/intro-to-the-webflow-api). |

**Provider documentation:** [Setup reference](https://developers.webflow.com/data/reference/authentication/site-token).

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **Webflow** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### List Sites

List Webflow sites accessible to the connected API token.

#### Inputs

No input fields are required in this catalog entry.

#### Outputs

| Field       | Type          | Description                                |
| ----------- | ------------- | ------------------------------------------ |
| Sites       | object\_array | Sites accessible to the current API token. |
| Site IDs    | array         | List of site ids returned.                 |
| Total Count | integer       | Number of sites returned.                  |

### List Collections

List CMS collections defined in a Webflow site.

#### Inputs

| Field | Type            | Required | Description                                                            |
| ----- | --------------- | -------- | ---------------------------------------------------------------------- |
| Site  | select (string) | No       | Optional. The Webflow site. Options load from the selected connection. |

#### Outputs

| Field          | Type          | Description                            |
| -------------- | ------------- | -------------------------------------- |
| Collections    | object\_array | Collections defined in the site's CMS. |
| Collection IDs | array         | List of collection ids returned.       |
| Total Count    | integer       | Number of collections returned.        |

### Get Collection

Fetch a Webflow CMS collection, including its full field schema.

#### Inputs

| Field      | Type            | Required | Description                                                                                                                                    |
| ---------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site       | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |

#### Outputs

| Field         | Type          | Description                                              |
| ------------- | ------------- | -------------------------------------------------------- |
| Collection ID | string        | The collection id.                                       |
| Display Name  | string        | Collection display name.                                 |
| Singular Name | string        | Singular form of the collection name.                    |
| Slug          | string        | URL-friendly collection slug.                            |
| Fields        | object\_array | Field schema for the collection.                         |
| Created On    | string        | ISO 8601 timestamp when the collection was created.      |
| Last Updated  | string        | ISO 8601 timestamp when the collection was last updated. |

### List Items

List items in a Webflow CMS collection with offset-based pagination.

#### Inputs

| Field                | Type            | Required | Description                                                                                                                                    |
| -------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site                 | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection           | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Limit                | integer         | No       | Maximum items to return (default: 25, max: 100). Minimum: 1. Maximum: 100. Default: 25.                                                        |
| Offset               | integer         | No       | Number of items to skip for pagination (default 0). Minimum: 0. Default: 0.                                                                    |
| CMS Locale ID        | string          | No       | Optional locale id. Leave empty to use the primary locale.                                                                                     |
| Fields               | array           | No       | Optional list of field slugs to include in each item's field\_data. Leave empty to return all fields.                                          |
| Max Field Characters | integer         | No       | Optional maximum length for any string field value. Longer values are truncated with a marker. Leave empty for no truncation. Minimum: 1.      |

#### Outputs

| Field          | Type          | Description                                        |
| -------------- | ------------- | -------------------------------------------------- |
| Items          | object\_array | Collection items in the requested page.            |
| Item IDs       | array         | List of item ids returned.                         |
| Total          | integer       | Total item count across all pages.                 |
| Returned Count | integer       | Number of items returned in this page.             |
| Has More       | boolean       | Whether more items are available beyond this page. |

### Get Item

Fetch a single item from a Webflow CMS collection by id.

#### Inputs

| Field         | Type            | Required | Description                                                                                                                                    |
| ------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site          | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection    | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Item ID       | string          | Yes      | The Webflow CMS item.                                                                                                                          |
| CMS Locale ID | string          | No       | Optional locale id. Leave empty to use the primary locale.                                                                                     |

#### Outputs

| Field          | Type    | Description                                                         |
| -------------- | ------- | ------------------------------------------------------------------- |
| Item ID        | string  | The id of the item.                                                 |
| Draft          | boolean | Whether the item is currently a draft.                              |
| Archived       | boolean | Whether the item is currently archived.                             |
| CMS Locale ID  | string  | The locale id the item was returned in.                             |
| Field Data     | object  | Field values stored on the item.                                    |
| Last Published | string  | ISO 8601 timestamp of the last publish, or null if never published. |
| Last Updated   | string  | ISO 8601 timestamp of the last update.                              |
| Created On     | string  | ISO 8601 timestamp when the item was created.                       |

### Create Item

Create a new item in a Webflow CMS collection. Items default to draft — run Publish Items to make them live.

#### Inputs

| Field          | Type            | Required | Description                                                                                                                                    |
| -------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site           | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection     | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Field Data     | object          | Yes      | JSON object of field values. Must include name and slug; other keys match the collection's field slugs.                                        |
| Draft          | boolean         | No       | Create the item as a draft (default true). Drafts are unpublished. Default: true.                                                              |
| Archived       | boolean         | No       | Create the item archived (default false). Default: false.                                                                                      |
| CMS Locale IDs | array           | No       | Optional list of locale ids. Leave unset for the primary locale.                                                                               |

#### Outputs

| Field      | Type    | Description                                   |
| ---------- | ------- | --------------------------------------------- |
| Item ID    | string  | The id of the created item.                   |
| Draft      | boolean | Whether the item was created as a draft.      |
| Archived   | boolean | Whether the item was created archived.        |
| Field Data | object  | Field values stored on the item.              |
| Created On | string  | ISO 8601 timestamp when the item was created. |

### Create Items (Bulk)

Create up to 100 items in a Webflow CMS collection in a single request. Items default to draft.

#### Inputs

| Field      | Type            | Required | Description                                                                                                                                    |
| ---------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site       | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Items      | array           | Yes      | Up to 100 items to create in a single request. Each entry must include field\_data with at minimum name and slug.                              |

#### Outputs

| Field         | Type          | Description                                               |
| ------------- | ------------- | --------------------------------------------------------- |
| Items         | object\_array | Items created by Webflow, in the same order as the input. |
| Item IDs      | array         | Ids of the created items.                                 |
| Created Count | integer       | Number of items created.                                  |

### Update Item

Update a Webflow CMS item's fields or toggle its draft/archived status.

#### Inputs

| Field      | Type            | Required | Description                                                                                                                                    |
| ---------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site       | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Item ID    | string          | Yes      | The Webflow CMS item.                                                                                                                          |
| Field Data | object          | No       | JSON object of field values to patch. Omit to only toggle status flags.                                                                        |
| Draft      | boolean         | No       | If set, toggle the item's draft status.                                                                                                        |
| Archived   | boolean         | No       | If set, toggle the item's archived status.                                                                                                     |

#### Outputs

| Field        | Type    | Description                                       |
| ------------ | ------- | ------------------------------------------------- |
| Item ID      | string  | The id of the updated item.                       |
| Draft        | boolean | Whether the item is currently a draft.            |
| Archived     | boolean | Whether the item is currently archived.           |
| Field Data   | object  | Field values stored on the item after the update. |
| Last Updated | string  | ISO 8601 timestamp of the latest update.          |

### Delete Item

Delete an item from a Webflow CMS collection.

#### Inputs

| Field      | Type            | Required | Description                                                                                                                                    |
| ---------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site       | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Item ID    | string          | Yes      | The Webflow CMS item.                                                                                                                          |

#### Outputs

| Field   | Type    | Description                                  |
| ------- | ------- | -------------------------------------------- |
| Deleted | boolean | True when the item was deleted successfully. |
| Item ID | string  | The id of the deleted item.                  |

### Delete Items (Bulk)

Delete up to 100 items from a Webflow CMS collection in a single request. Deletion is permanent.

#### Inputs

| Field      | Type            | Required | Description                                                                                                                                    |
| ---------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site       | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Item IDs   | array           | Yes      | List of item ids to delete (max 100 per request).                                                                                              |

#### Outputs

| Field         | Type    | Description                                         |
| ------------- | ------- | --------------------------------------------------- |
| Deleted       | boolean | True when Webflow accepted the bulk delete request. |
| Item IDs      | array   | Ids that were submitted for deletion.               |
| Deleted Count | integer | Number of item ids submitted for deletion.          |

### Publish Site

Publish a Webflow site to its Webflow subdomain and/or custom domains.

#### Inputs

| Field                        | Type            | Required | Description                                                                    |
| ---------------------------- | --------------- | -------- | ------------------------------------------------------------------------------ |
| Site                         | select (string) | No       | Optional. The Webflow site. Options load from the selected connection.         |
| Publish to Webflow Subdomain | boolean         | No       | Publish to the default \*.webflow\.io subdomain (default true). Default: true. |
| Custom Domain IDs            | array           | No       | Optional list of custom domain ids to publish to.                              |

#### Outputs

| Field                          | Type          | Description                                         |
| ------------------------------ | ------------- | --------------------------------------------------- |
| Published                      | boolean       | True when the publish was queued successfully.      |
| Custom Domains                 | object\_array | Custom domains included in the publish response.    |
| Published to Webflow Subdomain | boolean       | Whether the publish included the Webflow subdomain. |

### Publish Items

Publish selected items in a Webflow CMS collection live.

#### Inputs

| Field      | Type            | Required | Description                                                                                                                                    |
| ---------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Site       | select (string) | No       | Optional. The Webflow site that owns the collection; used only to populate the collection dropdown. Options load from the selected connection. |
| Collection | select (string) | Yes      | The Webflow CMS collection. Options load from the selected connection.                                                                         |
| Item IDs   | array           | Yes      | List of item ids to publish (max 100 per request).                                                                                             |

#### Outputs

| Field              | Type  | Description                                          |
| ------------------ | ----- | ---------------------------------------------------- |
| Published Item IDs | array | Ids of items confirmed as published by Webflow.      |
| Errors             | array | Per-item publish error messages returned by Webflow. |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/webflow.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
