Form Render

Description

The Form Render module allows generating pre-populated forms with data from the workflow. It queries the database to get the form structure, processes the field mapping with dynamic variables, and generates a temporary session with the pre-populated data (valid for 24 hours). It supports three output modes: form URL, direct HTML response with the rendered form, or HTTP redirect to the form. It is ideal for creating customer service forms, personalized surveys, or approval forms that need pre-loaded data.

Configuration

Parameter	Type	Required	Description
form_id	form_selector	Yes	Select the form to render
field_mapping	key_value_mapping	No	Mapping of workflow data to form fields (supports `{{variable}}`)
output_type	select	No	Output type: form URL, direct HTML response, or form redirect (default: url)
redirect_after_submit	boolean	No	Redirect after submitting the form (default: false)
custom_title	text	No	Custom title (supports `{{variable}}` variables)
custom_description	textarea	No	Custom description (supports `{{variable}}` variables)

Output

URL Mode (default)

{
  "nextModule": null,
  "data": {
    "success": true,
    "form_url": "https://app.ejemplo.com/f/abc123?prefill=hash456",
    "session_hash": "hash456",
    "form_id": "1",
    "form_name": "Mi Formulario",
    "prefill_data": { "nombre": "Juan", "email": "juan@test.com" },
    "expires_at": "2024-01-02T00:00:00.000Z"
  }
}

Redirect mode

{
  "nextModule": null,
  "data": {
    "code_response": 302,
    "headers": { "Location": "https://app.ejemplo.com/f/abc123?prefill=hash456" },
    "body_response": "<html>...</html>"
  }
}

Usage Example

Basic case

{
  "form_id": "15",
  "field_mapping": {
    "nombre": "{{clienteNombre}}",
    "email": "{{clienteEmail}}",
    "pedido_id": "{{orderId}}"
  },
  "output_type": "url",
  "custom_title": "Formulario para {{clienteNombre}}"
}

Notes

Supports dynamic variables {{variable}} in field_mapping, custom_title and custom_description
The pre-populated data session expires in 24 hours
Data is stored in the form_prefill_sessions table
The form is searched in the forms table of the database
HTML mode generates a complete form with integrated CSS styles and JavaScript for submission
html and redirect modes stop the workflow flow (_stopflowprocess: true)
Supported field types: text, textarea, select, checkbox, hidden, header, divider, paragraph

webresponse (custom HTTP response)
http (HTTP requests)