Overview
The Formaloo Trigger node listens for events related to forms created on the Formaloo platform. It triggers workflows in n8n when specific activities occur on a selected form, such as new submissions, updates to existing entries, or completed payments.
This node is beneficial for automating processes that depend on user interactions with Formaloo forms. For example:
- Automatically processing data when a new form submission arrives.
- Updating CRM records when a form entry is modified.
- Initiating follow-up actions after a payment is completed through a form.
By connecting Formaloo form events to other services via n8n, users can streamline data handling and automate business workflows efficiently.
Properties
| Name | Meaning |
|---|---|
| Form Name or ID | Select a Formaloo form from a dropdown list or specify its ID using an expression. This identifies which form's events will trigger the workflow. |
| Event Type | Choose the type of event to listen for: - Form Submit: Trigger on new form submissions. - Row Update: Trigger when an existing form entry is updated. - Payment Completed: Trigger when a payment linked to the form is completed. - All: Trigger on any of the above events. |
Output
The node outputs JSON data representing the event payload received from Formaloo. The output includes:
- All data sent by Formaloo about the form event (e.g., submission details, updated row data, payment info).
- A
_webhook_metadataobject containing:received_at: Timestamp when the webhook was received.form_slug: Identifier of the form triggering the event.event_type: The type of event that triggered the workflow.webhook_slug: Internal identifier for the webhook.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for Formaloo with appropriate permissions.
- Needs network access to Formaloo's API endpoints (
https://api.formaloo.me/v3.0/). - The node uses JWT tokens generated from a secret API key for authentication.
- Proper webhook URL configuration in n8n to receive POST requests from Formaloo.
Troubleshooting
- Missing Credentials Error: If the node throws an error about missing credentials, ensure that the Formaloo API key and secret are correctly configured in n8n.
- Webhook Creation Failure: Errors during webhook creation may indicate invalid form IDs, insufficient permissions, or network issues. Verify the form exists and credentials have webhook management rights.
- Webhook Not Triggering: Confirm that the webhook URL is publicly accessible and properly registered with Formaloo. Also, check that the selected event type matches the expected form activity.
- JSON Parsing Errors: If the incoming webhook payload is malformed, the node attempts to parse it safely but may output an error object instead. Check the source of the webhook calls for correctness.