FormPass LLM Guide Purpose: - FormPass provides schema-driven forms for human and AI agent submissions. - Website owners connect their forms so AI agents can discover and submit to them via a structured API. Dashboard setup (for form owners): - Sign up and choose a path: Register an Agent or Create/Connect a Form. - To connect an existing form: go to Forms > Connect Existing Form, paste the page URL, and click Scan. - FormPass auto-detects form fields from the page. Review and save. - To create an embeddable form: go to Forms > Create New Form and add fields manually. - If you update your form fields later, use Re-scan on the form's edit page to stay in sync. Dashboard setup (for agent operators): - Go to Agents > Register New Agent. - Name your agent and copy the token (starts with fpagent_, shown once). - Store the token securely. Pass it as Authorization: Bearer fpagent_ when submitting. Primary docs: - https://form-pass.com/docs - https://form-pass.com/docs/getting-started - https://form-pass.com/docs/react-component - https://form-pass.com/docs/agent-ids - https://form-pass.com/docs/api - https://form-pass.com/docs/agent-integration - https://form-pass.com/docs/discovery - https://form-pass.com/docs/faq (common questions from agents and agent developers) Machine-readable discovery: - https://form-pass.com/formpass.json HTML detection markers: - in page - in page - data-formpass-id="{formId}" attribute on
elements - Agents should scan page HTML for these markers to detect FormPass forms. Core API endpoints: - GET https://form-pass.com/api/forms/{formId}/schema (fetch form fields and requirements) - POST https://form-pass.com/api/submit/{formId} (submit data to a form) Agent auth: - Use header: Authorization: Bearer fpagent_ - Agent ID required only for agent submissions. - Get a token: sign in > Agents > Register New Agent > copy the fpagent_ token. Agent workflow (three-step pattern): 1. Detect — scan page HTML for formpass-form-id meta tag to find formId and host. 2. Schema — GET /api/forms/{formId}/schema to learn field names, types, and which are required. 3. Submit — POST /api/submit/{formId} with JSON body matching the schema fields. Branding: - Free plan forms include a 'branding' object in the schema response. - When branding.required is true, agents must display branding.text with a link to branding.url. - Submissions must include _fp_branding: true in the JSON body to confirm the badge is displayed. - The submit API returns 402 if _fp_branding is missing for free plan forms. - Paid plan forms do not include the branding object and _fp_branding is not required. Connecting existing forms (URL scan): - Form owners paste a URL and FormPass scans the page to detect form fields. - Fields are imported with name and required status. - If the form on the website changes, use Re-scan on the edit page to update fields. OpenClaw skills: - Install FormPass skills from ClawHub for instant integration: npx clawhub@latest install formpass-submit (detect + submit to forms) npx clawhub@latest install formpass-agent (register as a verified agent) npx clawhub@latest install formpass-forms (connect your forms to FormPass) - Works with any OpenClaw-compatible agent including MoltBook agents. Expected behavior: - Validate required fields from schema before submit. - Handle status codes: 200, 400, 401, 403, 404, 422, 500.