Developer Documentation & API Reference
Integrate headless forms in minutes. Learn how to submit HTML, React, and multipart payloads, configure multi-step conditional schemas, enable spam & CORS protection, verify HMAC webhooks, and query the REST API.
01. Form Ingestion, Multi-Step Schemas & Conditional Logic
Every FormFork endpoint (POST /f/{formId}) accepts standard application/x-www-form-urlencoded, multipart/form-data, and application/json payloads. Include Accept: application/json for headless JSON responses, or omit it for automatic browser thank-you and redirect handling.
<form action="https://your-domain.com/f/form-contact-demo" method="POST">
<input type="text" name="name" placeholder="Full Name" required />
<input type="email" name="email" placeholder="Work Email" required />
<textarea name="message" placeholder="Project Scope" required></textarea>
<!-- Honeypot Bot Protection (Keep hidden and empty) -->
<input type="text" name="_gotcha" style="display:none" tabindex="-1" autocomplete="off" />
<button type="submit">Submit Inquiry</button>
</form>Multi-Step & Conditional Rule Schema
{
"steps": [
{ "id": "step-1", "title": "Contact & Qualification", "description": "Basic team info" },
{ "id": "step-2", "title": "Technical Scope & Sign-Off", "description": "Requirements & NDA" }
],
"fields": [
{
"name": "inquiry_type",
"label": "Inquiry Category",
"type": "select",
"options": ["Enterprise Partnership", "Custom API Integration", "General Support"],
"required": true,
"step": 1
},
{
"name": "enterprise_budget",
"label": "Target Annual Contract Budget",
"type": "select",
"options": ["$10,000 - $25,000", "$25,000 - $100,000", "$100,000+"],
"required": false,
"step": 1,
"logic": {
"enabled": true,
"action": "show",
"operator": "equals",
"sourceField": "inquiry_type",
"value": "Enterprise Partnership"
}
}
]
}Supported Field Types & Logic Operators
Supported Schema Field Types
text · email · textarea · number · tel · date · select · checkbox · rating · matrix · signature · file
Conditional Visibility Operators (field.logic)
- equals / not_equals — Exact case-insensitive value match
- contains — Substring match on source field
- greater_than — Numeric threshold comparison (e.g. rating > 3)
- is_empty / is_not_empty — Presence evaluation
Code Generator Parity
In the Form Studio Integration & Code tab, FormFork compiles your multi-step wizard, conditional logic rules, and selected theme into ready-to-embed HTML, React, and Next.js components.
Official WordPress Plugin (FormFork Connect & Form Builder)
Pre-configured with https://formfork.io. Adds a top-level FormFork menu in WordPress Admin with All Forms, Form Builder (with live interactive preview), and Settings, plus an Elementor Widget, Gutenberg Block, and Classic Editor picker.
Quick Installation & Setup
- Download
formfork-connect.zipand upload via Plugins → Add New → Upload Plugin in WordPress. - Open the top-level FormFork → Settings menu in the WordPress sidebar.
- Paste your
ff_live_...Server API Key to sync existing forms, build new forms from WP Admin, and enable the zero-CORS WordPress AJAX proxy.
Shortcode & Editor Usage
# Native Responsive HTML (Default)
[formfork id="form-contact-demo"]
# Custom Theme & Submit Label Override
[formfork id="form-contact-demo" theme="midnight-neon" button_text="Send Request"]
# Hosted Iframe Embed
[formfork id="form-contact-demo" mode="iframe" height="620"]