---
title: list_forms, create_form, update_form
description: Create and manage forms with email notifications.
section: MCP Reference
order: 10
---

# list_forms, create_form, update_form

Create and manage forms with email notifications and webhooks.

## Actions

### list

List all forms for a website. Pass `form_id` to retrieve a single form with full field details.

**Parameters:**
- `domain` — Website subdomain, domain, or UUID
- `form_id` — Optional form UUID to retrieve a single form

### create

Create a new form.

**Parameters:**
- `domain` — Website subdomain, domain, or UUID
- `name` — Human-readable form name
- `fields` — Field definitions
- `notification_email` — Email to notify on submissions (optional)
- `success_message` — Flash message after submission (optional)
- `redirect_path` — Redirect path after submission (optional)

### update

Update form settings.

**Parameters:**
- `form_id` — Form UUID
- `fields` — Updated field definitions
- `notification_email` — Update notification email (optional)
- `success_message` — Update success message (optional)
- `redirect_path` — Update redirect path (optional)

## Field Types

`text`, `email`, `textarea`, `select`, `checkbox`, `radio`, `number`, `url`, `tel`, `search`, `range`, `color`, `date`, `datetime-local`, `time`, `month`, `week`, `hidden`

## OAuth Scopes

| Action | Scope |
|--------|-------|
| list | `form:read` |
| create | `form:create` |
| update | `form:edit` |