> ## 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.

# Embed Forms

Use hosted pages, iframe embeds, HTML POST, JSON submit, and multipart upload.

# Embed Forms

RogerIQ forms can be used without the full widget.

## Hosted Page

Use the hosted form when you want RogerIQ to render the page.

```txt
https://rogeriq.com/forms/:formId
https://rogeriq.com/f/:slugOrId
```

## Fetch the Form Schema

```bash
curl https://api.rogeriq.com/api/forms/contact/public
```

## JSON Submit

```bash
curl https://api.rogeriq.com/api/f/contact \
  -H "Content-Type: application/json" \
  -H "Origin: https://example.com" \
  -d '{
    "email": "ada@example.com",
    "message": "I need help with my order."
  }'
```

## HTML POST

```html
<form method="post" action="https://api.rogeriq.com/api/f/contact">
  <input type="text" name="_rq_hp" hidden tabindex="-1" autocomplete="off" />
  <input type="email" name="email" required />
  <textarea name="message" required></textarea>
  <button type="submit">Send</button>
</form>
```

## iframe Embed

```html
<iframe
  src="https://rogeriq.com/forms/contact"
  width="100%"
  height="640"
  style="border:0"
></iframe>
```

## Response

JSON submissions return:

```json
{
  "success": true,
  "data": {
    "submissionId": "sub_...",
    "redirectUrl": null,
    "successMessage": "Thanks. We received your message."
  }
}
```

HTML submissions that prefer `text/html` receive a `303` redirect to the configured success URL or hosted thank-you page.