API Reference - FormFlow
Enterprise-grade forms, zero code required
Available Endpoints
Interact with FormFlow’s submission pipeline, form templates, and webhook configurations via our RESTful API. All routes are scoped to https://api.formflow.io/v1.
GET /forms
Retrieve a paginated list of all forms associated with your workspace. Supports filtering by status (draft, published, archived) and creation date range.
POST /forms/{formId}/submissions
Programmatically inject a new submission. Automatically triggers validation rules, conditional logic, and configured Zapier/Make.com webhooks.
GET /submissions/{submissionId}/export
Fetch a specific submission payload in JSON or CSV format. Includes metadata like IP address, user agent, and completion timestamp.
PATCH /forms/{formId}/settings
Update form configuration including reCAPTCHA v3 thresholds, auto-response email templates, and GDPR data retention policies.
Request Examples
Authenticate using Bearer tokens generated in your FormFlow dashboard under Settings > API Keys. Include the token in the Authorization header for every request.
Authentication Header
Authorization: Bearer ff_live_sk_8x92mKpLqR4vT7wYz3nJ6bH5dA2cF1gE
POST /forms/frm_9482xq/submissions
{ "fields": { "full_name": "Elena Rostova", "company_email": "elena@nexuslogistics.com", "annual_revenue": 240000, "implementation_tier": "enterprise" }, "metadata": { "source_campaign": "q3_abm_outreach", "utm_medium": "linkedin_sponsored" } }
Response Payload (201 Created)
{ "id": "sub_7731mc92", "form_id": "frm_9482xq", "status": "completed", "created_at": "2024-05-14T09:22:15Z", "ip_address": "76.142.19.8", "webhook_delivery": "success" }
Response Codes
FormFlow follows standard HTTP semantics. Review the table below for expected status codes and troubleshooting steps for rate limiting or validation failures.
200 OK / 201 Created
Request succeeded. For POST endpoints, a 201 response includes the newly