# Send FormPass Submit to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "formpass-submit",
    "name": "FormPass Submit",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/jezjsa/formpass-submit",
    "canonicalUrl": "https://clawhub.ai/jezjsa/formpass-submit",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/formpass-submit",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=formpass-submit",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "formpass-submit",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:19:38.493Z",
      "expiresAt": "2026-05-07T03:19:38.493Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=formpass-submit",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=formpass-submit",
        "contentDisposition": "attachment; filename=\"formpass-submit-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "formpass-submit"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/formpass-submit"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/formpass-submit",
    "downloadUrl": "https://openagent3.xyz/downloads/formpass-submit",
    "agentUrl": "https://openagent3.xyz/skills/formpass-submit/agent",
    "manifestUrl": "https://openagent3.xyz/skills/formpass-submit/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/formpass-submit/agent.md"
  }
}
```
## Documentation

### FormPass — 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": "john@example.com"
    },
    {
      "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": "agent@example.com",
    "message": "Hello from an AI agent",
    "_fp_branding": true
  }' | jq .

Success response:

{
  "success": true,
  "submissionId": "jh72..."
}

### Required Headers

HeaderValueRequiredContent-Typeapplication/jsonYesAuthorizationBearer fpagent_XXXXRecommended

### The _fp_branding Field

If the schema response includes branding.required: true, you must include "_fp_branding": true in your submission body. Without it the API returns 402.

### Agent ID

Your Agent ID (format: fpagent_XXXX) is issued when you register at FormPass. It verifies your identity to form owners. Submissions without an Agent ID are recorded as anonymous/human.

To get an Agent ID, register at: https://form-pass.com/dashboard/agents/new

### Error Responses

StatusMeaning200Success — submission recorded402Branding required — add _fp_branding: true to your body404Form not found or inactive422Validation error — check required fields

The 422 response includes a fields array listing which fields failed validation.

### Full Example: Detect and Submit

# 1. You've found a page with formpass-form-id="abc123"
FORM_ID="abc123"
HOST="https://form-pass.com"

# 2. Get the schema
SCHEMA=$(curl -s "$HOST/api/forms/$FORM_ID/schema")
echo "$SCHEMA" | jq '.fields[] | {name, type, required}'

# 3. Build and submit your data
curl -s -X POST "$HOST/api/submit/$FORM_ID" \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer fpagent_your_id_here" \\
  -d '{
    "name": "Your Name",
    "email": "you@example.com",
    "message": "Submitted via OpenClaw agent",
    "_fp_branding": true
  }' | jq .

### Tips

Always fetch the schema first — field names and requirements can change.
Include your Agent ID to build trust with form owners. Anonymous submissions may be rejected.
If the schema shows agentAccessible: false, respect it and do not submit.
The _fp_branding field is stripped before data is stored — it's only for validation.
FormPass is a growing network. More forms are joining daily. Check any web form for the detection meta tags.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: jezjsa
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T03:19:38.493Z
- Expires at: 2026-05-07T03:19:38.493Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/formpass-submit)
- [Send to Agent page](https://openagent3.xyz/skills/formpass-submit/agent)
- [JSON manifest](https://openagent3.xyz/skills/formpass-submit/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/formpass-submit/agent.md)
- [Download page](https://openagent3.xyz/downloads/formpass-submit)