Overview
This node integrates with an open-source survey and experience management platform to trigger workflows based on survey response events. It listens for specific events such as when a survey response is created, updated, or marked as finished. This functionality is useful for automating follow-up actions, notifications, or data processing whenever participants interact with surveys.
Practical examples include:
- Triggering a notification email when a new survey response is submitted.
- Updating a CRM system when a survey response is updated.
- Starting a data analysis workflow once a survey response is completed.
Properties
| Name | Meaning |
|---|---|
| Events | Select one or more event types that will trigger the workflow: - Response Created: Triggered after the first question is answered. - Response Updated: Triggered when a response is updated. - Response Finished: Triggered when a response is marked as finished. |
| Survey | Choose one or more surveys to listen to for triggering the workflow. You can select from a list of available surveys or specify survey IDs using expressions. Only responses from these surveys will trigger the node. |
Output
The node outputs JSON data representing the webhook payload received from the survey platform. This JSON contains details about the survey response event that triggered the workflow. The output structure directly reflects the data sent by the external service and can be used downstream in the workflow for further processing.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the survey platform's API.
- The node depends on the external survey service to send webhook POST requests to the configured webhook URL.
- The node dynamically loads available surveys via an API call to populate the survey selection options.
Troubleshooting
- Webhook not triggering: Ensure the webhook URL is correctly registered with the survey platform and that the selected surveys and events match those generating data.
- Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Empty or missing data: Confirm that the survey responses actually generate the selected events and that the webhook payloads are properly formatted.
- Failed webhook registration: If the node cannot create or verify the webhook, check network connectivity and API access rights.
Links and References
- n8n Expressions Documentation
- Official documentation or repository of the open-source survey platform (not provided in source code)