FormPass

Getting started

Set up your FormPass account, connect your forms, and start receiving submissions from humans and AI agents.

1) Sign up and choose your path

After signing up, you'll land on the dashboard with two options:

Register an Agent

Create an Agent ID so AI agents can authenticate when submitting to your forms. Choose this if you're building an agent that needs to submit data.

Create or Connect a Form

Build an embeddable form from scratch, or scan an existing page to import its fields automatically.

The onboarding wizard guides you through both paths step by step. You can always switch or do both later.

2) Connect an existing form (URL scan)

If you already have a form on your website, FormPass can scan the page and import the fields automatically:

  1. Go to Forms → Connect Existing Form
  2. Paste the URL of the page that contains your form (e.g. https://yoursite.com/contact)
  3. Click Scan — FormPass will detect the form fields automatically
  4. Review the detected fields, toggle which ones are required, and save

Tip: If you ever update your form fields on your website, use the Re-scan button on the form's edit page to keep FormPass in sync.

3) Register an agent

Agents authenticate using a Bearer token. To get one:

  1. Go to Agents → Register New Agent
  2. Give the agent a name (e.g. "My Support Bot")
  3. Copy the token — it starts with fpagent_ and is only shown once
  4. Store it securely and pass it as Authorization: Bearer fpagent_... in submit requests

See Agent IDs for more on authentication and security.

4) Add the connect snippet to your site

Once your form is created, add meta tags to your page so agents can discover it:

<!-- Add to your page's <head> -->
<meta name="formpass-form-id" content="YOUR_FORM_ID">
<meta name="formpass-host" content="https://form-pass.com">

You can find the full snippet (with your actual form ID) on the Connect Your Form tab of any form in the dashboard.

5) Verify your endpoints

# Fetch form schema (public)
GET /api/forms/{formId}/schema

# Submit as a human
POST /api/submit/{formId}
Content-Type: application/json

{
  "name": "Ada Lovelace",
  "email": "ada@example.com"
}

# Submit as an agent
POST /api/submit/{formId}
Content-Type: application/json
Authorization: Bearer fpagent_your_token

{
  "name": "Ada Lovelace",
  "email": "ada@example.com"
}

Self-hosting (developers)

If you want to run FormPass locally or deploy your own instance:

npm install
npx convex dev --configure existing
npm run dev

The app runs at http://localhost:3000. Convex setup writes the required environment values to .env.local.