Vote Kit icon

Vote Kit

Consume Vote Kit API

Actions8

Create Vote

AI-generated

Overview

This node operation allows users to create a new vote (poll) using the Vote Kit API. It is useful for scenarios where you want to set up a voting or polling system with customizable options such as title, description, voting limits, timing, and bonus rewards. For example, you can create a poll for event feedback, product feature prioritization, or community decision-making.

Use Case Examples

  1. Create a poll with a title, description, and multiple voting options.
  2. Set a maximum number of votes per user and specify the number of winners.
  3. Enable bonus rewards for voters and configure the percentage of bonus shared.

Properties

Name Meaning
Title Title of the vote/option.
Description Description of the vote.
Max Vote Per User Maximum votes allowed per user.
Winner Count Number of winners to be selected.
Start Time Start time of the vote.
End Time End time (deadline) of the vote.
Public Voter Info Whether voter information is public.
Public Option Create Whether the public can create options.
Public Comment Whether to allow comments on the vote.
Allow Update Vote Whether users are allowed to update their votes.
Hide Result Before End Whether to hide voting results before the vote ends.
Has Bonus Whether the vote has a bonus reward system.
Share Bonus to Voters Whether to share bonus rewards with voters.
Bonus Percentage for Voters Percentage of 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 limit is enabled.
Vote Options List of voting options.

Output

JSON

  • _id - ID of the created vote.
  • title - Title of the created vote.
  • description - Description of the created vote.
  • maxVotePerUser - Maximum votes allowed per user.
  • winnerCount - Number of winners.
  • deadline - End time of the vote.
  • startTime - Start time of the vote.
  • publicVoterInfo - Whether voter info is public.
  • publicCreate - Whether public can create options.
  • revote - Whether vote updates are allowed.
  • comment - Whether comments are allowed.
  • hideResultBeforeEnd - Whether results are hidden before the vote ends.
  • addBonus - Whether the vote has a bonus system.
  • rewardVoters - Whether bonus is shared with voters.
  • votersBonusPercentage - Bonus percentage shared with voters.
  • enableOptionLimit - Whether option limit per user is enabled.
  • optionLimit - Maximum options per user if limit is enabled.
  • options - List of voting options.

Dependencies

  • An API key credential for the Blocklet Component API

Troubleshooting

  • Ensure all required parameters like title and options are provided when creating a vote.
  • Check API credentials and permissions if requests fail.
  • If the vote creation fails, verify the date/time formats for startTime and deadline are correct.
  • If bonus-related options are enabled, ensure the bonus percentage is a valid number.

Links

  • Vote Kit API Documentation - Official API documentation for Vote Kit, useful for understanding available endpoints and parameters.

Discussion