> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rogeriq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forms Overview

Build public intake forms that create support conversations.

# Forms Overview

RogerIQ forms are schema-driven intake surfaces. They are useful for contact forms, bug reports, quote requests, onboarding surveys, and any support workflow that needs structured fields before a conversation starts.

## Form Capabilities

| Capability | Description |
| --- | --- |
| Custom fields | Text, long text, email, number, phone, checkbox, radio, select, multi-select, date, and file fields. |
| Hosted pages | Public RogerIQ-hosted form pages. |
| Short routes | `/f/:slugOrId` for public access. |
| Embeds | iframe embeds, HTML POST, and JSON submit. |
| Success handling | Inline success message or redirect URL. |
| Origin controls | Optional allowed origin list. |
| Spam protection | Honeypot, rate limit, FingerprintIQ, and Turnstile on hosted pages. |
| Inbox creation | Each accepted submission creates a conversation. |

## Form Lifecycle

**Create a form**

Define name, slug, fields, success behavior, rate limits, and allowed origins.
  **Publish or embed**

Use the hosted page, iframe, HTML POST, JSON endpoint, or beacon.
  **Receive submissions**

Submissions create conversations and store the structured payload.
  **Review in Inbox**

Agents can respond, assign, tag, and resolve the conversation like any other support thread.

## Public Endpoints

| Endpoint | Description |
| --- | --- |
| `GET /api/forms/:id/public` | Fetch form schema. |
| `POST /api/f/:formId` | Submit JSON, multipart form data, or HTML form data. |
| `GET /forms/:formId` | Hosted form route on `rogeriq.com`. |
| `GET /f/:slugOrId` | Short hosted form route on `rogeriq.com`. |

Use forms when you need structured intake. Use the widget when a visitor needs search, AI answers, previous messages, and chat.