Forms
Forms collect structured information from customers — leads, intake, opt-ins, surveys. Install Forms under Team settings → Apps, then open Forms in the sidebar.
Overview
- Build forms with fields, title, and description
- Publish / lock, share URL, QR, smart link, or embed
- Review submissions (with activity sparkline on overview)
- Optional marketing opt-in, additional notification recipients, public results, list in shop
- Team members control email and push notifications in their notification settings
- Up to 10 additional recipient addresses per form can also receive every submission
- Chain a next action after submit (pick a warp + map inputs)
- Agents manage forms end-to-end over MCP when Forms is installed
In the app
- Open Forms
- New form — add fields; set options below
- Publish / make public when ready (private forms stay editable without accepting public traffic)
- Share via public URL, QR download, smart link, or embed path
- Open the form for submissions (delete one or clear all)
- Install into agent/warp flows when you want the agent to reuse the form (
install_form/ install modal)
Field types
string, textarea, email, phone, number, boolean, select
Editor options
| Option | Purpose |
|---|---|
| Fields | Questions / inputs |
| Next action | Pick a warp and map form outputs → warp inputs after successful submit |
| Marketing opt-in | Adds consent checkbox for campaigns |
| Additional recipients | Up to 10 extra email addresses that also receive every new response; team members follow their own notification settings |
| Public results | Optional /results page for respondents |
| In shop | Show the form on the team storefront |
Team members control email and push notifications for form submissions in their personal notification settings. Add up to 10 additional email addresses separated by commas in the form editor to also send each response to those addresses. Recipient addresses are only visible to team members, never on the public form. Agents can set the same recipients with notificationEmails on create_form / update_form.
Sharing
| Method | Notes |
|---|---|
| Public URL | https://forms.joai.ai/{locale}/{formId} |
| QR | From the form overview / actions |
| Smart link | Short branded link when Smart Links is available |
| Embed | https://forms.joai.ai/{locale}/{formId}/embed — iframe-friendly |
| Public results | …/{formId}/results and …/{formId}/results/embed when enabled |
| Install | Install into agent/warp flows |
Embed example:
<iframe
src="https://forms.joai.ai/en/YOUR-FORM-ID/embed"
title="Form"
style="width:100%;min-height:640px;border:0;"
loading="lazy"
></iframe>Unpublish or lock to stop public responses without deleting the form.
Public surfaces
- Primary host:
https://forms.joai.ai/{locale}/{formId} - Embed:
https://forms.joai.ai/{locale}/{formId}/embed - Results (optional):
…/resultsand…/results/embed - Optional listing on the Shop storefront when In shop is on
For agents (MCP)
Requires the Forms app.
| Tool | Purpose |
|---|---|
create_form | Create |
list_forms / get_form | List or fetch |
update_form / delete_form | Edit or remove |
add_form_field / update_form_field / remove_form_field | Fields |
publish_form / unpublish_form | Go live / pause |
install_form | Install for agent/warp use |
form_submissions | Read responses |
delete_form_submission / clear_form_submissions | Clean up |
After submit, continue with Contacts (find-or-create) or Campaigns (joai-campaign-send-contact).
Live schemas: tools/list. See MCP and SKILL.md.
Tips
- Keep fields minimal
- Use opt-in when you will email/SMS later
- Prefer find-or-create so submissions do not create duplicate contacts
- Lock/unpublish while editing a live form
Related
- Native apps
- Public surfaces
- Contacts
- Campaigns — oneshot follow-ups
- Automations — multi-step contact journeys after submit
- Smart Links
- Sites
- Shortcuts