# conForm

> Form-to-email API by Centrst. One POST creates a permanent form endpoint that
> delivers submissions to a verified inbox. No account, no API key, no
> submission storage. Open-source MIT engine, self-hostable on Cloudflare
> Workers.

Key facts for agents

- API base: https://api.conform.centrst.com — discovery: GET / or /.well-known/conform.json
- Create: POST /v1/routes {"email":"you@example.com","alias":"Contact"} -> {form_id, endpoint, status, management_token}
- Send an Idempotency-Key header so retries return the SAME endpoint instead of minting new ones.
- One human step: the destination inbox must confirm a verification email before
  delivery starts. Poll GET /v1/routes/{form_id} (next_action tells you exactly
  what to do). The endpoint URL is stable while pending — install the form immediately.
- Ready-to-install code: GET /v1/routes/{form_id}/install?framework=html|js|react|vue|svelte|astro|nextjs
- Test delivery without polluting real traffic: include _test=true in a submission;
  the response echoes test:true as proof. A test response WITHOUT test:true means
  the submission was spam-filtered — never populate the hidden _gotcha field.
- Clean up: DELETE /v1/routes/{form_id} with "Authorization: Bearer <management_token>".
- Optional account dashboards can list form metadata by verified inbox through the
  operator-authenticated POST /v1/account/routes interface. Destination plaintext,
  management tokens, and submissions are never returned.
- Quota: one inbox = one monthly allowance (250 deliveries/month) —
  +tags, Gmail dots, and provider domain aliases count as the same inbox.
- Every error is JSON: {success:false, error:<stable_code>, message, retryable}.

## Machine interfaces

- OpenAPI: https://api.conform.centrst.com/openapi.json
- Discovery document: https://api.conform.centrst.com/.well-known/conform.json
- MCP server: https://api.conform.centrst.com/mcp
- Docs: https://conform.centrst.com
- Source: https://github.com/centrst/conform-cf-worker