Form Nodes

> Send responses to form submissions, submit data to forms programmatically, and format form data for database storage.

Form nodes connect your flows to Brickr's form system. Forms can trigger route execution when a submission is received, and form nodes let you interact with form data within your routes.

Form Triggers

A form trigger is a way to automatically execute a route when a form receives a submission. To set this up:

1. Create a route in the Builder. 2. Open the Start Node settings. 3. Under Triggers, add a form_submission trigger. 4. Select which form should trigger this route.

When a user submits the selected form, the route executes automatically with the submission data available through the Start Node's output pins.

A single form can trigger multiple routes, and a single route can be triggered by multiple forms. Each trigger executes independently.

Response and Submission Nodes

form-send-response

Sends a response back to a form submission. Use this in form-triggered routes to provide feedback to the user who submitted the form.

| Pin | Direction | Type | |-----|-----------|------| | sequence in | Input | sequence | | response | Input | any | | sequence out | Output | sequence |

submit-to-form

Submits data to a form programmatically from within a route. This is useful for creating submissions from other data sources, migrating data, or building internal tools.

| Pin | Direction | Type | |-----|-----------|------| | sequence in | Input | sequence | | formId | Input | string | | data | Input | object | | success | Output | boolean | | submissionId | Output | string | | sequence out | Output | sequence |

The data input should be an object where keys match the form's field names and values are the data to submit.

Programmatic submissions through submit-to-form will also trigger any routes that are set up with form triggers for that form. Be careful to avoid infinite loops if a form-triggered route itself submits to the same form.

format-form-data-for-table

Transforms form submission data into a format compatible with Brickr table database rows. Use this to bridge form submissions directly into table inserts.

| Pin | Direction | Type | |-----|-----------|------| | formData | Input | object | | result | Output | object |

Chain format-form-data-for-table with create-table-row to store every form submission directly into a database table, ready for querying and reporting.

Not Yet Implemented

The following nodes exist in the node library but are not currently functional:

form-get-last-response

Intended to retrieve the most recent submission for a form. Not implemented.

form-get-all-responses

Intended to retrieve all submissions for a form. Not implemented.

These nodes are placeholders for future functionality. Do not use them in production routes -- they will not return data.