FormNode API v1
REST API reference. For AI agent integration, see MCP docs.
Open MCP Docs
Analytics API

Business workspaces can use FULL or READ_ONLY API keys to pull aggregate analytics into BI and dashboard tools. Analytics endpoints return rollups only and do not include raw submission payloads, contact details, comments, tokens, secrets, or webhook bodies.

curl -H "Authorization: Bearer fn_sk_..." \
  "https://app.formnode.io/api/v1/analytics/workspace?from=2026-04-01&to=2026-04-30&granularity=day"
Agent form testing

Business workspaces can give agents a READ_ONLY API key and let them inventory testable forms, run read-only smoke tests, and inspect dry-run payload previews. Smoke tests load dynamic fields and Matrix axes through the same public resolver paths a respondent uses, but they do not create submissions, dispatch webhooks, or store browser screenshots.

curl -H "Authorization: Bearer fn_sk_..." \
  "https://app.formnode.io/api/v1/agent/forms?tags=demo&tags=matrix&demoMode=true"

curl -X POST \
  -H "Authorization: Bearer fn_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"scenarioId":"northstar-quarterly-access-review"}' \
  "https://app.formnode.io/api/v1/agent/forms/{formId}/smoke-test"

For shared/global forms, include organizationId or use a demo scenario that supplies one. Responses include readiness flags, dependency hints, Matrix row/column counts, selected-cell counts, sanitized dynamic errors, and a payloadPreview showing the dry-run submission shape.