Simple Poll API

Use the Simple Poll API to programmatically create polls in Slack 🎉

Getting an API key

The Simple Poll API uses token authentication, you can get your api key from the dashboard: https://simplepoll.rocks/dashboard/my/settings/

The API key is personal to you and enables you to create polls in the Slack workspace you're a member of. Keep the API key secret.

Create a poll

To create a poll using the Simple Poll API, make a POST request to https://simplepoll.rocks/api/v1/polls/

Required fields

• channel_id : the Slack channel where to post the poll
• text : the poll text for example: "When are you in the office next week?" "Mon" "Tue" "Wed" "Thu" "Fri"

The text  field is the same as the text you can provide as a regular user in /poll [text] . Many options are available to configure your poll including anonymity, ranked polls, results visibility, scheduled closing, etc. All options are documented here: https://help.simplepoll.rocks/article/120-how-can-i-use-slash-commands-to-make-a-poll-quickly

Authorization

Provide your api key in the Authorization  header in the Bearer  format, so Authorization: Bearer [your api key]  as shown in the example curl request below

Example curl request

curl 'https://simplepoll.rocks/api/v1/polls/' \
--header 'Authorization: Bearer sp_your_api_key' \
--data '{
    "channel_id": "C09451D9SEM",
    "text": "\"When are you in the office next week?\" \"Mon\" \"Tue\" \"Wed\" \"Thu\" \"Fri\""
}'