Overview
This node acts as a trigger for n8n workflows, listening to specific events on Kizeo Forms. It sets up a webhook with Kizeo Forms so that when selected events (such as data being saved, updated, deleted, or pushed) occur on a specified form, the workflow is triggered in real time. This is useful for automating processes based on form submissions or changes, such as syncing data to other systems, sending notifications, or updating records.
Example scenarios:
- Automatically process new form submissions by triggering downstream automation.
- Notify a team when form data is updated or deleted.
- Sync form data to another application whenever it is changed in Kizeo Forms.
Properties
| Name | Meaning |
|---|---|
| Form Name or ID | Select a form from your Kizeo Forms account or specify its ID using an expression. This determines which form's events will trigger the workflow. |
| Event | Choose one or more events that will trigger the workflow: - Data Deleted - Data Saved - Data Updated - Push Received - Push Send |
Output
The node outputs the body of the incoming webhook request from Kizeo Forms as JSON. The exact structure depends on the event and Kizeo Forms' payload, but typically includes details about the form and the event that occurred.
Example output:
[
{
// All fields sent by Kizeo Forms in the webhook body
"form_id": "...",
"event_type": "...",
"data": { /* ... */ }
// ...other fields depending on the event
}
]
- The output is always in JSON format.
- No binary data is produced by this node.
Dependencies
- External Service: Requires access to the Kizeo Forms API.
- API Credentials: You must configure Kizeo Forms API credentials in n8n (
kizeoFormsApi). - n8n Configuration: The node must be accessible via a public URL if running outside of n8n Cloud, so Kizeo Forms can reach the webhook endpoint.
Troubleshooting
Common issues:
- Webhook not triggered: Ensure your n8n instance is publicly accessible and the webhook URL is correctly registered with Kizeo Forms.
- Authentication errors: Double-check your Kizeo Forms API credentials in n8n.
- Event mismatch: If the workflow does not trigger for expected events, verify that you have selected the correct events and form.
Error messages:
- "401 Unauthorized" or similar: Indicates invalid or missing API credentials.
- "Webhook already exists" or "Webhook not found": May occur if the webhook registration state is out of sync; try removing and re-adding the node.
- "Cannot read property 'webhookId' of undefined": Could indicate a problem with webhook setup or deletion; ensure the node is properly configured and has been executed at least once.