# Forms & Data Collection

> Form definitions, protected submissions with file uploads, and automatic contact capture.

> Markdown version of https://kanorio.com/en/developers/products/forms. Append `.md` to any developer docs URL for this format. Index: https://kanorio.com/llms.txt · MCP: https://app.kanorio.com/api/mcp

Status: **Available**

Forms collect information from visitors: contact requests, applications, bookings of interest and surveys. Submissions are data, not orders.

## Core objects

- **Forms.** Questions, consent settings, availability windows and confirmation emails, built in the dashboard.
- **Submissions.** Each visitor's answers and files, linked to the contact Kanorio creates or updates.

## How the APIs fit

- Show a form with `<kanorio-form>`, or build your own markup on the Content Delivery API's form endpoints, which handle bot protection and uploads.
- Bot protection is the built-in proof-of-work check by default. The site owner can switch to their own Cloudflare Turnstile, Google reCAPTCHA or hCaptcha keys under **Site settings › Bot protection**; `GET /site` returns the choice as `botProtection`, and `<kanorio-form>` renders the right widget automatically.
- Read submissions with the Management API.
- The `customers.form.submitted` webhook pushes each submission to your systems.

See the [Forms](https://kanorio.com/en/developers/guides/forms) guide.

## What the APIs expose

| Capability | Status | API | Elements | Hosted site | Webhooks |
| --- | --- | --- | --- | --- | --- |
| Forms & lead capture | Available | Management API `forms.list/get`, `submissions.list/get`; Delivery `GET /forms/:id`, `GET /forms/:id/challenge`, `POST /forms/:id/upload-request`, `POST /forms/:id/submit`; SDK `forms.client({ siteUrl })` | `<KanorioForm />` (`<kanorio-form>`), `<KanorioBotProtection />`, `useKanorioBotProtection()` | `/marketing/forms`, `/data/form_submissions`; page `form` section | `customers.form.submitted` |

## API reference

- Management API: [Forms](https://kanorio.com/en/developers/management-api/forms) (2 operations)
- Management API: [Submissions](https://kanorio.com/en/developers/management-api/submissions) (3 operations)
- Content Delivery API: [Forms](https://kanorio.com/en/developers/delivery-api/forms) (4 operations)

## Webhook events

- `customers.form.submitted`: Fired when a visitor submits an online form (notifies team and webhooks).

Payloads: https://kanorio.com/en/developers/webhooks/events

## Elements

- `<kanorio-form>`: Interactive form with client validation, an anti-spam challenge, private file uploads and submission handling.

## Guides

- [Forms](https://kanorio.com/en/developers/guides/forms): Put a Kanorio form on your own front end, with bot protection, file uploads, consent and contact capture handled for you.

## For site owners

Dashboard help: https://kanorio.com/en/help/online-forms