Developer API & Webhooks

GET /forms

List all forms in your workspace. Supports ?status=draft|published|archived and ?created_after=2024-01-15 query parameters. Returns up to 100 forms per page with cursor pagination.

POST /submissions

Create a new form submission programmatically. Submit a JSON object matching the form's field schema. FormFlow validates against required fields, conditional logic, and field-level constraints before persisting.

GET /submissions/:id/responses

Retrieve all responses for a specific form submission. Includes field metadata, timestamps, IP geolocation (if enabled), and the respondent's user agent string.

POST /webhooks

Register a webhook endpoint to receive real-time event payloads. Supports retry policies with exponential backout up to 72 hours and HMAC-256 signature verification.

Python (requests)

import requests

API_KEY = "ff_live_8h2kP9mQxR4vLn"
FORM_ID = "frm_9k2xLp4vN"

payload = {
    "vendor_name": "Meridian Supplies LLC",
    "contact_email": "ops@meridian-supp.io",
    "tax_id": "47-2918305",
    "compliance_certified": True,
    "preferred_payment": "net_45"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json"
}

resp = requests.post(
    f"https://api.formflow.dev/v1/submissions/{FORM_ID}",
    json=payload,
    headers=headers
)

print(resp.json())
# {"id": "sub_7wD3nRqF", "status": "complete", ...}

Node.js (fetch)

const API_KEY = "ff_live_8h2kP9mQxR4vLn";
const FORM_ID = "frm_9k2xLp4vN";

const payload = {
  vendor_name: "Meridian Supplies LLC",
  contact_email: "ops@meridian-supp.io",
  tax_id: "47-2918305",
  compliance_certified: true,
  preferred_payment: "net_45"
};

const resp = await fetch(
  `https://api.formflow.dev/v1/submissions/${FORM_ID}`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(payload)
  }
);

const data = await resp.json();
console.log(data);
// { id: "sub_7wD3nRqF", status: "complete", ... }

Starter Plan

120 requests / minute
20 concurrent connections
Max payload: 2 MB
Suitable for low-volume integrations and internal tools.

Pro Plan

600 requests / minute
50 concurrent connections
Max payload: 10 MB
Designed for production workflows and batch operations.

Enterprise Plan

2,400 requests / minute
200 concurrent connections
Max payload: 50 MB
Custom limits available on request. Dedicated support channel for scaling needs.