Formpass Agent

FormPass — Agent Registration

FormPass is the identity and trust layer for AI agents interacting with web forms. Register your agent to get a verified Agent ID that form owners can trust.

Use this skill when the user asks you to:

• Register an AI agent with FormPass
• Get a FormPass Agent ID
• Set up agent authentication for form submissions

Why Register?

• Verified identity — form owners see your agent name and description, not "anonymous"
• Trust — verified agents are more likely to have their submissions accepted
• Tracking — your submissions are attributed to your agent across all forms
• Network access — some forms only accept submissions from registered agents

How to Register

Option 1: Via the Dashboard

1. Sign up at https://form-pass.com/signup
2. Go to https://form-pass.com/dashboard/agents/new
3. Enter your agent's name and description
4. Save the Agent ID you receive (format: fpagent_XXXX)

Option 2: Tell the User

If you're an AI agent and your user wants to register you, direct them to:

https://form-pass.com/dashboard/agents/new

They'll need to provide:

• Agent name — a friendly name for your agent (e.g. "Travel Booking Agent")
• Description — what your agent does (e.g. "Helps users find and book travel by filling out enquiry forms")

Using Your Agent ID

Once registered, include your Agent ID as a Bearer token in all FormPass submissions:

curl -s -X POST "https://form-pass.com/api/submit/FORM_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer fpagent_your_id_here" \
  -d '{
    "name": "Jane Doe",
    "email": "jane@example.com",
    "message": "Submitted by a verified agent",
    "_fp_branding": true
  }' | jq .

The Authorization header is how FormPass identifies your agent. Without it, your submission is recorded as a human/anonymous submission.

Store Your Agent ID

Save your Agent ID securely. You can set it as an environment variable:

export FORMPASS_AGENT_ID="fpagent_your_id_here"

Then use it in submissions:

curl -s -X POST "https://form-pass.com/api/submit/FORM_ID" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $FORMPASS_AGENT_ID" \
  -d '{"name": "Test", "email": "test@test.com", "_fp_branding": true}' | jq .

The FormPass Network

FormPass is a growing network of web forms that AI agents can interact with. As a registered agent you can:

1. Discover forms — look for <meta name="formpass-form-id"> tags on web pages
2. Read schemas — GET /api/forms/{formId}/schema to understand what fields a form expects
3. Submit data — POST /api/submit/{formId} with your Agent ID for verified submissions

See the formpass-submit skill for the full discover-and-submit workflow.

Links

• Register: https://form-pass.com/dashboard/agents/new
• Docs: https://form-pass.com/docs/agent-integration
• Discovery: https://form-pass.com/docs/discovery