Message polls

Actions in the category "Message polls".

Create poll

Creates a new poll message in a channel using simple answer inputs.

Required permissions: Create polls.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	The channel where the poll will be posted.
Question	Text	Yes	The poll question (max 300 characters). Length: 1 to 300 characters.
Answers	List of Poll answer	Yes	List of poll answers (1-10). Items: 1 to 10.
Duration (hours)	Whole number	No	How long the poll stays open in hours (1-768). Value: 1 to 768. Default: 24.
Allow Multiple Answers	Yes/No	No	Whether voters may select more than one answer. Default: No.

Outputs

Name	Type	Details
Poll Message	Message	The poll message that was sent.

Send poll to channel

Sends a fully built poll object to a channel without any other message content.

Required permissions: Create polls.

Inputs

Name	Type	Required	Details
Channel	Server channel	Yes	The channel where the poll will be posted.
Poll	Poll	Yes	The poll definition to send.

Outputs

Name	Type	Details
Poll Message	Message	The poll message that was sent.

End poll immediately

Closes a poll right away, regardless of its scheduled duration.

Required permissions: Manage messages.

Inputs

Name	Type	Required	Details
Poll Message	Message	Yes	The message containing the poll to end.

Outputs

Name	Type	Details
Poll Message	Message	The poll message after being closed.

Fetch poll voters

Returns the users who voted for a specific answer in a poll.

Required permissions: Read message history.

Inputs

Name	Type	Required	Details
Poll Message	Message	Yes	The message containing the poll.
Answer ID	Whole number	Yes	The ID of the answer to query (1-based). Minimum: 1.
Limit	Whole number	No	Maximum number of voters to fetch (1-100). Value: 1 to 100. Default: 100.

Outputs

Name	Type	Details
Voters	List of User	Users who voted for the answer.