# FormIA

> FormIA (https://formia.cloud) is a Brazilian SaaS for conversational forms with a built-in multi-tenant CRM. Its public REST API v1 (base `https://formia.cloud/api/v1`, API key in `x-api-key` or `Authorization: Bearer`) lets apps and AI agents read forms and responses, upsert contacts, tag them, move them through pipeline stages, add notes, poll an events feed and manage signed account-wide webhooks. Docs are written in Brazilian Portuguese (pt-BR).

Rules for agents: read the complete guide before calling the API; use only documented endpoints and fields and never send unknown ones (they return 400 on the contacts, events, links and reward-file routes and are ignored on webhooks); send `Idempotency-Key` on every CRM write `POST`; honor `Retry-After` on 429/503; handle `410 EVENTS_CURSOR_EXPIRED` on the events feed; verify webhook signatures on the raw body; ask the human before destructive actions.

## Docs

- [Guia completo da API e dos webhooks do CRM (Markdown)](https://formia.cloud/docs/crm-api.md): autenticação, planos, escopos, todas as rotas v1 com exemplos, idempotência, limites, feed de eventos, webhooks (payloads, assinatura, retentativas), consentimento, receitas, erros e um prompt pronto para agentes
- [Mesmo guia em página web](https://formia.cloud/docs/crm-api)

## API reference

- [OpenAPI JSON (só a API pública v1)](https://formia.cloud/api/docs-json)
- [Swagger UI](https://formia.cloud/api/docs)