Formaloo

Submit data to Formaloo forms

Overview

This node integrates with Formaloo, a platform for creating and managing online forms. It allows users to submit data programmatically to a specified Formaloo form. This is useful in scenarios where you want to automate form submissions based on external triggers or workflows, such as submitting survey responses collected from other systems, automating registration forms, or sending data to Formaloo without manual input.

For example, you could use this node to:

Automatically submit customer feedback collected from another app into a Formaloo survey.
Populate a Formaloo registration form with user data from a CRM system.
Batch submit multiple entries to a Formaloo form as part of an automated workflow.

Properties

Name	Meaning
Operation	The action to perform. Currently supports only "Submit Form" which submits data to a Formaloo form.
Form Name or ID	Select the target Formaloo form by name or ID. You can choose from a dropdown list loaded dynamically or specify the form ID using an expression.
Form Data	The data to submit to the form. This is a collection of fields where each field requires: - Field Name or ID: The identifier of the form field (loaded dynamically). - Value: The value to submit for that field.

The Form Data property supports multiple fields to be submitted at once.

Output

The node outputs an array with one item per input item processed. Each output item contains a json object with the following structure:

success: Boolean indicating if the submission was successful.
response: The raw response returned by the Formaloo API after submission.
submittedData: The actual data sent to the form.
formSlug: The identifier of the form to which data was submitted.
timestamp: ISO string timestamp of when the submission occurred.
If an error occurs and "Continue On Fail" is enabled, the output will contain:
- success: false
- error: Error message describing what went wrong.
- timestamp: Timestamp of the failure.

The node does not output binary data.

Dependencies

Requires a Formaloo API credential containing an API key and a secret API token.
Uses Formaloo's REST API v3.0 endpoint to submit form data.
Requires network access to https://api.formaloo.me.
The node dynamically loads available forms and form fields via helper methods.
Needs proper configuration of credentials in n8n to authenticate requests.

Troubleshooting

Missing Credentials: If the API key or secret token is missing or invalid, the node throws an error asking to check Formaloo API credentials.
Form Not Selected: If no form is selected or the form ID is empty, an error prompts to select a form.
Invalid Field Values: For fields with options like dropdowns, choices, multiple selects, city, or country, if the provided value does not match any available option, the node throws an error specifying the problematic value.
No Valid Fields: If no valid fields are found in the form data to submit, an error indicates that the form data should be checked.
API Errors: Any errors returned by the Formaloo API during submission will cause the node to fail unless "Continue On Fail" is enabled, in which case the error details are included in the output.

To resolve these issues:

Ensure credentials are correctly set up and valid.
Select a valid form from the dropdown or provide a correct form ID.
Provide valid field IDs and values matching the form's expected inputs.
Use expressions carefully to ensure dynamic values are correct.
Enable "Continue On Fail" to handle errors gracefully in workflows.