formpass-submit
Discover and submit to FormPass-enabled web forms. FormPass is the trust layer that lets verified AI agents submit to real web forms with authenticated identity.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/jezjsa/formpass-submitFormPass — Discover & Submit to Forms
FormPass is the identity and trust layer for AI agents submitting to web forms. Instead of scraping HTML and guessing field names, you get a structured API with schema validation and authenticated submissions.
Use this skill when the user asks you to:
- Fill out or submit a web form
- Apply to something via a form
- Send a contact/enquiry/signup form
- Interact with any FormPass-enabled form
How It Works
FormPass forms expose a three-step flow: detect → schema → submit.
Step 1: Detect a FormPass Form
When visiting a web page, look for these meta tags in the HTML <head>:
<meta name="formpass-form-id" content="FORM_ID_HERE">
<meta name="formpass-host" content="https://form-pass.com">
If you find them, extract the formpass-form-id value — that's the Form ID.
You can also check these discovery endpoints:
# Machine-readable discovery
curl -s https://form-pass.com/formpass.json | jq .
# LLM-friendly guide
curl -s https://form-pass.com/llms.txt
Step 2: Get the Form Schema
Fetch the form's field definitions before submitting. This tells you exactly what fields exist, which are required, and what types they expect.
curl -s "https://form-pass.com/api/forms/FORM_ID/schema" \
-H "Accept: application/json" | jq .
Response:
{
"formId": "abc123",
"name": "Contact Form",
"description": "Get in touch with us",
"agentAccessible": true,
"fields": [
{
"name": "name",
"label": "Full Name",
"type": "text",
"required": true,
"placeholder": "John Doe"
},
{
"name": "email",
"label": "Email Address",
"type": "email",
"required": true,
"placeholder": "[email protected]"
},
{
"name": "message",
"label": "Message",
"type": "textarea",
"required": false,
"placeholder": "How can we help?"
}
],
"branding": {
"required": true,
"text": "Powered by FormPass",
"url": "https://form-pass.com"
}
}
Important: If agentAccessible is false, the form owner has disabled agent submissions. Do not attempt to submit.
Step 3: Submit to the Form
POST your data as JSON. Include your Agent ID as a Bearer token if you have one (this identifies you as a verified agent).
curl -s -X POST "https://form-pass.com/api/submit/FORM_ID" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_AGENT_ID" \
-d '{
"name": "Agent Smith",
"email": "[email protected]",
"message": "Hello from an AI agent",
"_fp_branding": true
}' | jq .
Success response:
{
"success": true,
"submissionId": "jh72..."
}
Required Headers
| Header | Value | Required |
|---|---|---|
Content-Type | application/json | Yes |
Authorization | Bearer fpagent_XXXX | Recommended |
The _fp_branding Field
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-jezjsa-formpass-submit": {
"enabled": true,
"auto_update": true
}
}
}