---
ref: tool:webflow/list-form-submissions
name: List form submissions
company: company:webflow
workflows: []
access: [mcp, cli, api]
tags: [capability:collect-responses, category:cms, has:api, has:cli, has:mcp]
docs: https://developers.webflow.com/data/reference/forms/form-submissions/list-submissions
updated: 2026-09-27
---

# List form submissions

Returns the submissions of one form on a site, up to 100 per page.

On the MCP server, use the `list_form_submissions` action of
`data_forms_tool` with `site_id` and `form_id`; its `list_forms` action finds
the form. Page with `offset` and `limit`. A form placed inside a component
yields one form per instance: to collect them all, list by site with
`GET /sites/{site_id}/form_submissions` and the form's `elementId`. The CLI
can export submissions to CSV with `--output`.

## Set up

Use the first option your agent supports.

### MCP (official, remote)

Add this server to your agent's MCP settings, then sign in when asked.

```json
{ "mcpServers": { "webflow": { "url": "https://mcp.webflow.com/mcp" } } }
```

Call the MCP tool `data_forms_tool`.

Server URL: https://mcp.webflow.com/mcp

### CLI (official)

Install the command, then confirm it runs.

```sh
npm install -g @webflow/webflow-cli
webflow --version
```

Run `webflow forms submissions`.

### API (official)

- Base URL: https://api.webflow.com/v2
- Endpoint: `GET /sites/{site_id}/forms/{form_id}/submissions`
- Auth: send the header `Authorization: Bearer $WEBFLOW_API_TOKEN`
- Docs: https://developers.webflow.com/data/reference/rest-introduction

Before doing anything else, make one read-only call to confirm access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
