Overview
This node integrates with an open-source survey and experience management platform to trigger workflows based on specific survey response events. It listens for webhook events such as when a new survey response is created, updated, or marked as finished. This allows users to automate processes like notifying teams, updating databases, or triggering follow-up actions whenever survey responses change.
Common scenarios include:
- Automatically processing new survey responses as they come in.
- Tracking updates to ongoing survey responses.
- Taking action once a survey response is completed.
For example, a user could set up this node to trigger a workflow that sends a thank-you email immediately after a respondent finishes a survey.
Properties
| Name | Meaning |
|---|---|
| Events | Select one or more event types that will trigger the workflow: - Response Created: Triggered when a new response is created (usually after first question answered). - Response Updated: Triggered when an existing response is updated. - Response Finished: Triggered when a response is marked as finished. |
| Survey | Choose one or more surveys by their IDs to listen for events from. Only triggers for selected surveys within the environment. You can select from a list or specify IDs using expressions. |
Output
The node outputs the webhook payload received from the survey platform as JSON data. The output contains the full event data related to the triggered survey response event, allowing downstream nodes to access all relevant information about the response.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the survey platform's API.
- Needs proper configuration of the webhook URL in the survey platform to send events to n8n.
- Uses internal methods to fetch available surveys dynamically for property selection.
Troubleshooting
- Webhook not triggering: Ensure the webhook URL configured in the survey platform matches the URL generated by this node. Also, verify that the selected survey IDs and event types correspond to actual surveys and events in your environment.
- Permission errors: Confirm that the API key used has sufficient permissions to create and manage webhooks.
- Empty or missing data: Check that the survey platform is sending the expected payload and that the node’s properties are correctly set to listen for those events.
- Webhook creation failure: Network issues or incorrect API credentials may prevent webhook registration. Verify connectivity and credentials.
Links and References
- n8n Expressions Documentation
- Formbricks official website or documentation (not provided in code, but typically available on the project site)