Overview
This node integrates with the Vote Kit API to manage online voting polls and their options. It supports operations such as creating, updating, deleting, retrieving, and listing votes (polls) and vote options. The "List Votes" operation specifically retrieves a paginated list of existing votes.
Common scenarios for this node include:
- Managing community or organizational polls programmatically.
- Automating the retrieval of active or past votes for reporting or analysis.
- Integrating voting data into workflows that require decision-making based on poll results.
For example, you could use the "List Votes" operation to fetch batches of polls for display in a dashboard or to trigger notifications when new polls are created.
Properties
| Name | Meaning |
|---|---|
| Page Size | Number of votes to retrieve per page. |
| Page Count | The page number to retrieve, starting from 1. |
These properties control pagination when listing votes, allowing you to specify how many votes to fetch and which page of results to access.
Output
The output is a JSON array where each item represents a vote (poll) object returned by the Vote Kit API. Each vote object typically contains details such as the poll's title, description, voting limits, timing, visibility settings, bonus configurations, and options.
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential for authenticating requests to the Vote Kit API.
- The node uses a helper function to make HTTP requests to the Vote Kit backend endpoints.
- Proper configuration of the API authentication credential within n8n is necessary.
Troubleshooting
Common issues:
- Pagination parameters out of range may result in empty responses.
- Network or authentication errors if the API key is missing or invalid.
- API rate limits might cause request failures.
Error messages:
- Errors returned from the API will be included in the node output if "Continue On Fail" is enabled.
- Typical error messages include authorization failures or invalid parameter errors.
Resolutions:
- Verify that the API key credential is correctly set up and has sufficient permissions.
- Ensure that "Page Size" and "Page Count" are positive integers.
- Check network connectivity and API endpoint availability.
Links and References
- Vote Kit Official Documentation (replace with actual URL)
- n8n HTTP Request Node Documentation (for understanding underlying API calls)