Docs
Everything you need to create forms, read responses and let agents fill forms. Start with the quickstart.
Quickstart: create a form, share it and read the responses
Get an API key, create a form, share the link and read the responses in 5 minutes. Examples in curl, JavaScript and Python.
Authentication: one API key, sent as a Bearer token
How to get an AI Form API key, send it as a Bearer token, keep it safe and rotate it. Public and token endpoints need no key.
Forms and fields: the 11 field types and every setting
Create, list, update, close and delete forms. All 11 field types with examples, form settings and the blocked fields we reject.
Read form responses as JSON or CSV
Fetch responses as JSON or CSV, page through them with a cursor, use since to fetch only new rows, and know what each source value means.
Agent fill: how a visitor hands your form to their own AI agent
How agent fill works: the exact prompt, Path A (agent with tools), Path B (paste the answer back), what the person sees and how to turn it off.
Fill API: submit answers to a form with a fill token
Read a form and submit answers with a fill token. Complete requests and the 201, 410, 422 and 429 responses, in curl, JavaScript and Python.
MCP server setup for AI Form API
Connect your AI agent to AI Form API with MCP. Creator server with an API key header, plus the authless fill connector for Claude.ai and ChatGPT.
Form webhooks: a signed POST for every new response
Get a signed POST to your server for each new form response. Payload, headers, retries, and signature checks in Node and Python.
Rate limits and quotas: every number on the free plan
Every limit on the free plan, the RateLimit headers on each response, how to back off after a 429, and retry code in JavaScript and Python.
API error codes: what each one means and how to fix it
Every AI Form API error code with its HTTP status, what causes it and how to fix it. All errors share one JSON shape.
Embed a form on your website with one script tag
Add an AI Form API form to any web page with one script tag. The script creates an iframe that resizes to fit the form.
agent-fill.js: let visitors hand any HTML form to their AI agent
A script that lets visitors hand any existing HTML form to their AI agent. It makes no API call and no data leaves the page.
AI Form API changelog: what v0 includes
What the first version of AI Form API includes: the REST API, creator and fill MCP servers, agent fill, webhooks, CSV and JSON export.