# Mailform API

Mailform is an API-first contact form service for form creation, installation, public submissions, and inquiry management. Email delivery is not included in this MVP.

Base URL: https://mailform.junno.org
OpenAPI: https://mailform.junno.org/openapi.json
Health: GET /health
Authentication: management endpoints require Authorization: Bearer <token>.

Recommended agent workflow:
1. Install the CLI from /downloads/mailform-0.2.0.tgz with npm install --global.
2. Set MAILFORM_API_TOKEN without writing it into the site repository.
3. Run mailform setup --origin https://example.com --name Contact --json.
4. Connect the generated page or component to the site's route.
5. Run mailform verify --url https://example.com/contact --json against a preview.
6. Run mailform doctor --json when setup or verification fails.

MCP: run mailform-mcp over stdio. It exposes form creation, code generation, test storage, and storage verification.

Never expose a management token in public site code. Public forms use only publicKey.
Prefer formIds-limited API keys for agents operating on one site.