Vote Kit

Consume Vote Kit API

Actions8

Overview

This node integrates with the Vote Kit API to manage voting polls and options. It supports creating, updating, retrieving, listing, and deleting votes (polls) and their options. The node is useful for automating workflows involving online polls, such as managing community votes, surveys, contests, or decision-making processes.

For example, you can use this node to:

Create a new poll with specific voting rules and options.
Update an existing poll’s details like title, description, or voting limits.
Retrieve poll results or details.
Manage individual vote options by adding, updating, or removing them.
List multiple polls with pagination support.

Properties

Name	Meaning
Title	Title of the vote or option.
Description	Description text explaining the vote.
Max Vote Per User	Maximum number of votes allowed per user in the poll.
Winner Count	Number of winners to be selected in the poll.
Start Time	Date and time when the poll starts.
End Time	Deadline date and time when the poll ends.
Public Voter Info	Whether voter information is publicly visible.
Public Option Create	Whether users can publicly create new options in the poll.
Public Comment	Whether comments are allowed on the poll.
Allow Update Vote	Whether voters are allowed to update their votes after submission.
Hide Result Before End	Whether to hide poll results until the poll deadline has passed.
Has Bonus	Whether the poll includes a bonus reward system.
Share Bonus to Voters	Whether to share the bonus rewards with voters.
Bonus Percentage for Voters	Percentage of the bonus shared with voters if enabled.
Limit Options Per User	Whether to limit the number of options a user can select.
Max Options Per User	Maximum number of options a user can select if option limit is enabled.
Vote Options	List of vote options (titles) for the poll.
Vote ID	Unique identifier of the vote (poll). Required for operations that modify or retrieve existing polls.

Output

The node outputs JSON data representing the response from the Vote Kit API for the performed operation. This typically includes:

For create/update operations: The updated or newly created poll or option object with all its properties.
For get operations: Detailed poll or option data including current votes, options, and settings.
For list operations: A paginated list of polls.
For delete operations: Confirmation of deletion.

No binary data output is produced by this node.

Dependencies

Requires an API key credential to authenticate requests to the Vote Kit API.
Uses internal helper functions to make HTTP requests to endpoints such as /api/poll, /api/admin/poll/create, /api/poll-options/create, etc.
The node expects the environment to have access to the Vote Kit service endpoints.

Troubleshooting

Common issues:
- Invalid or missing poll ID when updating, deleting, or retrieving a vote will cause errors.
- Providing invalid dates or numbers outside expected ranges may result in API validation errors.
- Network or authentication failures will prevent successful API calls.
Error messages:
- Errors returned from the API are propagated as error messages in the node output.
- If "Continue On Fail" is enabled, errors for individual items are returned as JSON objects with an error field containing the message.
Resolutions:
- Ensure required parameters like pollId and optionId are correctly set.
- Verify API credentials and network connectivity.
- Validate input data types and constraints before execution.

Links and References

Vote Kit official documentation (not provided here; check your Vote Kit API docs)
n8n HTTP Request node documentation for understanding API request handling
General polling and voting system design principles for context on property usage