Skip to content

FormFlow developer platform

Build, publish and read forms from your own code. REST API, webhooks, a TypeScript SDK and an embeddable renderer.

Quick start

1. Create an API key in Settings, Developers. 2. Call the API with Authorization: Bearer ff_live_....

bash
curl -X POST https://YOUR_HOST/api/v1/forms \
  -H "Authorization: Bearer $FORMFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"name":"Contact","templateId":"contact"}'

curl -X POST https://YOUR_HOST/api/v1/forms/FORM_ID/publish \
  -H "Authorization: Bearer $FORMFLOW_API_KEY"

Every response is { data, nextCursor? } or { error: { code, message, details? } }. Lists use cursor pagination with limit up to 100.

Concepts

A form has an editable draft and immutable versions. Publishing snapshots the draft and its resolved theme; respondents and submissions only ever see published versions. Editing the draft afterwards never changes what is served.

Next

Read Authentication, then the API reference. Building an app? See Mobile apps for the iOS, Android, React Native and Flutter SDKs. Subscribe to webhooks to react to submission.completed.