# FormsList

> FormsList (formslist.com) is a form backend as a service: point any HTML form's action at a FormsList endpoint and it handles submissions, email notifications, spam filtering, auto-responses, integrations (webhooks, Slack, Discord, Telegram, Google Sheets, Notion, Airtable), and analytics — no server code. It is built to be usable end-to-end by AI agents: forms can be provisioned in a single unauthenticated API call.

## For AI agents (fastest path)

Provision a live form endpoint in ONE call — no signup, no API key:

    POST https://formslist.com/api/v1/instant
    Content-Type: application/json
    {"email": "site-owner@example.com", "form_name": "Contact form"}

The response contains `endpoint` (live immediately — POST submissions to it), `html_snippet` (paste into the site), `curl_example`, and `claim_url` (emailed to the owner; they claim a dashboard later). Unclaimed forms expire after 7 days. Submission notifications go to the provided email from the first submission.

- GET any form endpoint (https://formslist.com/f/HASH) returns machine-readable usage docs for that form.
- All public-endpoint errors return {"error", "fix", "docs_url"} so agents can self-correct.
- MCP server available: see https://formslist.com/blog/mcp-server-for-forms (tools: instant_provision, create_form, list_forms, get_form, get_submissions, configure_autoresponse, get_embed_snippet).

## Key pages

- [For AI agents](https://formslist.com/ai): the AI-native integration guide
- [API documentation](https://formslist.com/docs): REST v1 — Bearer keys prefixed ff_sk_, created at /account/api-keys
- [OpenAPI spec](https://formslist.com/api/v1/openapi.json)
- [Full agent guide](https://formslist.com/llms-full.txt)
- [Pricing](https://formslist.com/pricing): Free (5 forms, 500 submissions/mo), Pro $15/mo or $150/yr, Business $45/mo or $450/yr

## How submissions work

Point a form at https://formslist.com/f/YOUR_HASH (method POST; accepts JSON, form-urlencoded, multipart). Special fields: _subject (notification subject), _replyto, _next (redirect URL), _gotcha (honeypot — include hidden + empty). JSON requests get {"ok": true}; browser posts get a 303 redirect. Spam protection (honeypot + heuristic scoring + duplicate detection) is automatic and free on every plan.

## Blog

- [Add a Contact Form to Any Site with Claude in 10 Seconds](https://formslist.com/blog/add-contact-form-with-claude-in-10-seconds): Your AI assistant can build an entire website in one session — but the contact form it writes goes nowhere without a backend. Here is the fastest working path: one curl to FormsList's instant provisioning API, paste the returned snippet, claim your dashboard from your inbox. Plus the MCP route, where Claude does all three steps itself.
- [An MCP Server for Forms: Let Your AI Agent Manage Form Submissions](https://formslist.com/blog/mcp-server-for-forms): formslist-mcp gives Claude Code, Claude Desktop, and Cursor seven typed tools for form infrastructure: provision endpoints without an account, create and inspect forms, pull submissions, configure auto-responses, and generate embed snippets. Here is the plain-English MCP primer, the config for each client, and a tool-by-tool walkthrough.
- [FormsList Is Now AI-Native: The Form Backend That Works Before You Sign Up](https://formslist.com/blog/formslist-is-now-ai-native): AI agents build thousands of websites a day, and every one of them needs a working contact form. Every form backend — including ours, until today — made the agent stop and wait for a human to sign up first. Today we ship instant provisioning, an MCP server, and self-documenting endpoints. The form works immediately; the human claims it after.
- [7 Best Formspree Alternatives in 2026 (Tested and Ranked)](https://formslist.com/blog/formspree-alternatives-2026): We signed up for, configured, and stress-tested every Formspree alternative on the market — Getform, Basin, Web3Forms, Formcarry, FormSubmit, Netlify Forms, and FormsList. Here's the honest verdict on which wins for which use case.
- [Why Your Contact Form Isn't Sending Emails: A Complete Debugging Checklist](https://formslist.com/blog/why-contact-form-not-sending-emails): Your form looks fine. Submissions seem to work. But no email arrives. Here's a systematic 9-step debugging checklist to find and fix the actual cause — covering DNS, SPF/DKIM/DMARC, spam filters, and silent backend failures.
- [Form Spam in 2026: The Complete Prevention Playbook](https://formslist.com/blog/form-spam-prevention-2026): Bot traffic now accounts for ~50% of all internet activity. A single unprotected contact form can collect 200+ spam submissions per day within a week of going live. Here's how every defensive layer actually works — honeypots, CAPTCHAs, AI scoring, rate limiting — and which combination to use for what risk level.