AgentForms lets AI agents create forms, send links to humans, and receive structured JSON responses. Like a form builder, but API-first.
1from agentforms import AgentForms, fields 2 3client = AgentForms(api_key="af_live_xxxxx") 4 5form = client.create_form( 6 title="Confirm your shipping details", 7 fields=[ 8 fields.Text("full_name", label="Full name", required=True), 9 fields.Select("size", label="T-shirt size", options=["S", "M", "L", "XL"]), 10 fields.Email("email", label="Email address"), 11 fields.Checkbox("confirm", label="I confirm this order", required=True), 12 ], 13 callback_url="https://my-agent.com/hooks/order", 14 expires_in="24h", 15) 16 17print(form.url) # → https://agentforms.io/f/frm_01Jxxxx
1curl -X POST https://api.agentforms.io/v1/forms \ 2 -H "Authorization: Bearer af_live_xxxxx" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "title": "Confirm your shipping details", 6 "fields": [ 7 {"type": "text", "key": "full_name", "label": "Full name", "required": true}, 8 {"type": "select", "key": "size", "label": "T-shirt size", "options": ["S","M","L","XL"]}, 9 {"type": "email", "key": "email", "label": "Email address"}, 10 {"type": "checkbox", "key": "confirm", "label": "I confirm this order", "required": true} 11 ], 12 "callback_url": "https://my-agent.com/hooks/order", 13 "expires_in": "24h" 14 }'
1// TypeScript SDK — coming soon 2// npm install agentforms 3// 4// import { AgentForms } from 'agentforms'; 5// const client = new AgentForms({ apiKey: 'af_live_xxxxx' });
Your agent does the work. Humans just fill in the blanks.
Your agent defines the form via API. Fields, validation, expiry — all in one call.
Send the form link to a human. Email, Slack, SMS — wherever they are.
Get structured JSON via webhook. Signed, verified, ready to process.
Everything you need to collect human input programmatically.
Every feature accessible via REST API. No UI to click through, no manual steps. Your agent talks JSON, we talk JSON back.
Text, email, select, multi-select, number, date, textarea, checkbox. More coming.
HMAC-SHA256 signed payloads delivered to your endpoint. Auto-retry with exponential backoff.
Built-in MCP server. Your agent creates forms as naturally as sending a message. No glue code required.
Sync and async clients. Type-safe. Published on PyPI.
SSL everywhere, HMAC-signed webhooks, auto-expiring form links, and API key authentication out of the box.
Structured, signed, and ready to process. No parsing headaches.
1{ 2 "event": "form.completed", 3 "form_id": "frm_01JxAbC3dE", 4 "form_title": "Confirm your shipping details", 5 "submitted_at": "2025-03-04T14:22:33Z", 6 "data": { 7 "full_name": "Maria Rossi", 8 "size": "L", 9 "email": "maria@example.com", 10 "confirm": true 11 }, 12 "metadata": { 13 "ip": "203.0.113.42", 14 "user_agent": "Mozilla/5.0...", 15 "duration_seconds": 47 16 } 17}
"data" — Your structured response, exactly as defined in the form schema.
"metadata" — Submission context included automatically. IP, user agent, time spent.
Wherever your agent needs a human, AgentForms handles the handoff.
Your agent collects customer info during onboarding — name, preferences, requirements — without building custom forms.
Agent needs a manager's sign-off? Create a form, send the link, get a structured yes/no with comments.
Surveys, feedback forms, expense reports — your agent handles the logistics, humans provide the input.
One agent creates the form, a human fills it, another agent picks up the response and continues the workflow.
No credit card required. Upgrade or cancel anytime.
All plans include: SSL, HMAC-signed webhooks, auto-expiry, and full API access.
Start building in minutes. No credit card, no sales calls.