# conForm

> Form submission backend for people and robots, by Centrst. One POST creates a
> permanent form endpoint that delivers submissions to a verified inbox. No
> account, no API key, no submission storage. Bring your own HTML — there is no
> form builder and no client library. Open-source MIT engine, self-hostable on
> Cloudflare Workers.

Key facts for agents

- API base: https://api.conform.centrst.com — machine discovery at GET / or
  /.well-known/conform.json, full spec at /openapi.json
- Create a form: POST /v1/routes {"email":"you@example.com","alias":"Contact"}
  -> {form_id, endpoint, status, management_token, next_action}
- Send an Idempotency-Key header so retries return the SAME endpoint instead of
  minting new ones. Store the management_token — it authorizes deletion.
- One human step: the destination inbox must confirm a verification email before
  delivery starts. Poll GET /v1/routes/{form_id} until status is "active". The
  endpoint URL is stable while pending — install the form immediately.
- Ready-to-install accessible code:
  GET /v1/routes/{form_id}/install?framework=html|js|react|vue|svelte|astro|nextjs
  (Vite and other bundlers: use the js artifact.)
- Prove delivery with a marked test: submit with _test=true; the response
  carries test: true and echoes a non-boolean _test value. A test response
  WITHOUT test: true means it was spam-filtered — never fill the hidden
  _gotcha field.
- Quota: every form delivering to the same inbox shares one monthly allowance
  (250 deliveries/month free).
- Every error is JSON: {success:false, error:<stable_code>, message, retryable}.
- MCP server for coding agents: https://api.conform.centrst.com/mcp
  (streamable HTTP; tools: create_form, get_form_status, get_install_code,
  send_test_submission, get_service_info)

## Docs

- Quickstart (form backend for static websites): https://conform.centrst.com/docs/
- API reference (form-to-email API): https://conform.centrst.com/docs/api/
- For AI agents (full autonomous workflow + MCP): https://conform.centrst.com/docs/agents/
- Recipes: https://conform.centrst.com/docs/html/ (plain HTML),
  /docs/javascript/, /docs/vite/, /docs/react/, /docs/nextjs/, /docs/vue/,
  /docs/svelte/, /docs/astro/
- Self-hosting the open-source Worker: https://conform.centrst.com/docs/self-host/
- Trust — where form data exists: https://conform.centrst.com/trust/
- vs Web3Forms: https://conform.centrst.com/compare/web3forms/
- vs Formspree: https://conform.centrst.com/compare/formspree/
- Everything above inlined: https://conform.centrst.com/llms-full.txt

## Machine interfaces

- OpenAPI: https://api.conform.centrst.com/openapi.json
- Discovery document: https://api.conform.centrst.com/.well-known/conform.json
- API-host llms.txt: https://api.conform.centrst.com/llms.txt
- Source (same code as hosted): https://github.com/centrst/conform-cf-worker

## Web

- Landing and form creation: https://conform.centrst.com/
- Parent company: https://centrst.com/