Overview
This node triggers a workflow when a specific Zigpoll survey is completed. It listens for completion events from the Zigpoll service and activates the workflow with the survey response data. This is useful for automating processes based on survey results, such as sending follow-up emails, updating CRM records, or generating reports immediately after a survey is submitted.
Practical examples:
- Automatically notify a sales team when a customer completes a satisfaction survey.
- Trigger a marketing campaign based on responses to a product feedback poll.
- Log survey results into a database or spreadsheet in real-time.
Properties
| Name | Meaning |
|---|---|
| Survey Name or ID | Select the survey to listen for. Choose from a dropdown list of available surveys or specify an ID using an expression. |
Output
The node outputs JSON data representing the completed survey event received from Zigpoll. The output JSON includes all details sent by Zigpoll about the survey completion, including at least the pollId and other related metadata. Additionally, the node adds a receivedAt timestamp indicating when the event was processed.
No binary data is output by this node.
Example output JSON structure:
{
"pollId": "string",
"responseData": { /* survey response details */ },
"receivedAt": 1680000000000
}
Dependencies
- Requires an API key credential for Zigpoll to authenticate requests.
- Needs internet access to communicate with the Zigpoll API endpoints.
- The node registers a webhook URL with Zigpoll to receive survey completion events.
Troubleshooting
- Invalid API Key: If authentication fails, ensure the provided API key is correct and has necessary permissions. The node will report "Token is not valid" if authentication fails.
- Webhook Registration Issues: If the webhook cannot be created or deleted, verify network connectivity and that the Zigpoll API is reachable.
- Survey ID Mismatch: The node only triggers when the incoming event’s
pollIdmatches the configured survey ID. Ensure the correct survey is selected. - No Trigger on Survey Completion: Confirm that the webhook URL is correctly registered in Zigpoll and that Zigpoll is sending events to it.
Links and References
- Zigpoll API Documentation (for API endpoints and webhook setup)
- n8n Expressions Documentation (for using expressions in property fields)