Enterprise Business Use Cases
Proprietary System Ingestion
If your company runs a highly customized, internally built CRM or ERP system, simply expose an endpoint, paste the URL into Flex Forms, and let your internal servers ingest the JSON payload seamlessly.
Ultra-Detailed, Step-by-Step Setup Guide
Connecting Flex Forms via Custom Webhooks is incredibly simple, as it only requires a valid URL.1
Step 1: Prepare Your Endpoint
Ensure your server (or an intermediary service like Make.com) has exposed a public URL that is configured to accept incoming HTTP
POST requests containing application/json payloads.2
Step 2: Copy the URL
Copy the full, secure HTTPS URL of your endpoint (e.g.,
https://api.yourcompany.com/v1/webhooks/flex-forms).3
Step 3: Inject the URL into Flex Forms
Open your Flex Forms administrative dashboard.
Form-Level Configuration: Because different forms require different routing logic, you configure Webhooks at the Form Level, not the Global Settings level.
- Open the specific form you want to connect in the Flex Forms Studio.
- Open the form hub and select the Integrations tab.
- Find the Webhooks section.
- Paste the URL you copied into the input field.
- Save your form.
Configuration & Masterclass Usage
There is no field mapping required for Custom Webhooks. Flex Forms simply packages all the form data, based exactly on the block names you defined in the Studio, into a clean, flat JSON object and fires it at the URL.The JSON Payload Architecture
When a user submits the form, your server will receive a POST request with a body that looks exactly like this:Troubleshooting & Enterprise FAQs
API Error: Timeout
API Error: Timeout
The Problem: The form submission seems to hang or fail, and the logs show a timeout.The Solution: Flex Forms expects your endpoint to return a
200 OK status code quickly. If your server receives the webhook, spends 30 seconds processing a complex database query, and then returns a 200, Flex Forms will time out and assume the request failed. Your endpoint should immediately return a 200 OK acknowledging receipt, and then process the data asynchronously in the background.Security & Authentication
Security & Authentication
The Problem: How do I verify the webhook actually came from Flex Forms?The Solution: Currently, the webhook payload is a simple, unsigned JSON object. If you require strict security, we recommend appending a secret token as a URL parameter to your endpoint URL (e.g.,
https://api.yourcompany.com/webhook?secret=123456789). Your server can then reject any POST requests that do not include this exact secret parameter.Configuration Reference
The following advanced settings are available in the Flex Forms UI for this integration. Use this reference to understand exactly how each field impacts the API payload.Global Settings
Located in Integrations in the Flex Forms left rail. There are no global settings for generic Webhooks. All webhook endpoints are configured on a per-form basis.Form-Level Settings
Located on the form hub Integrations tab for a specific form.Endpoint Configuration
text
required
Request URL
The destination server URL. Must begin with
https://. Flex Forms blocks local IP addresses (e.g., 127.0.0.1, 192.168.x.x) to prevent Server-Side Request Forgery (SSRF) attacks. You can use merge tags (e.g., https://api.example.com/hooks/{{department_id}}) to route requests dynamically.select
default:"POST"
Request method
The HTTP verb used for the request.Options:
POST: Standard for creating records.PUT/PATCH: Often used for updating resources.GET/DELETE: When using these, the payload body is automatically converted into query string parameters (e.g.,?email=test&name=john).
textarea
Request headers
Pass custom HTTP headers for authentication or API routing. You must provide one header per line using the format
Header-Name=Value.Example:
Authorization=Bearer {{token_field}}
X-Custom-Form-Id=submissionPayload Formatting
select
default:"json"
Request format
How the payload data is serialized.Options:
json: Sends a strictapplication/jsonpayload. Best for modern APIs.form: Sends data asapplication/x-www-form-urlencoded. Often required by legacy systems.
select
default:"all_fields"
Request body
Determines what data is included in the webhook payload.Options:
all_fields: Automatically dumps every form answer into the payload.select_fields: Gives you strict control, forcing you to define a specificfield_valuesmap.
textarea
Field values
Only used if
body_type is set to select_fields.
Manually construct the exact JSON keys or form parameters sent to the server. Format is payload_key=form_block_name (or literal text).Example:
customer_email=email
source=website_form (literal)select
default:"0"
Include submission meta
Only applies when
body_type is all_fields.
If enabled (Yes), Flex Forms automatically injects system metadata (Form ID, Form Title, Submission ID, and Submitted At timestamp) into the root of the webhook payload.