Webhook integration for receiving vote data

Instead of requesting our API to see the users who have voted for your bot, you can now use webhooks! Webhooks will send a post request to a URL of your choice when your bot has been voted for.

Getting Started

Start by setting up your webhook URL in the edit form of your bot on this site, it can be found at Once you've entered the URL you want the webhook to be sent to, you're all set! If you need help setting up webhooks inside of your bot don't be afraid to ask in our discord server in the #api channel.

Verifying the request

On the edit page you can see another input for Authorization. Here you can provide a shared secret that you can check for on the server side.

To verify requests are coming from us, look for the value in the Authorization header and make sure it is the same as the value you provided in the form.


Webhooks sent by must be acknowledged with an HTTP 200 response. Webhook requests that time out or return a non-200 response will be retried once after 1 minute. libraries will perform this response automatically.

Data Format

The format of the data your webhook URL will receive in a POST request.


botsnowflakeDiscord ID of the bot that received a vote.
usersnowflakeDiscord ID of the user who voted.
typestringThe type of the vote (should always be "upvote" except when using the test button it's "test").
isWeekendbooleanWhether the weekend multiplier is in effect, meaning users votes count as two.
query?stringQuery string params found on the /bot/:ID/vote page. Example: ?a=1&b=2.

More Events

Looking for webhooks events other than votes? They are only available starting from v1 of the API.

You are currently viewing v0.
Edit on GitHub