Skip to content

Instantly share code, notes, and snippets.

@mezotv

mezotv/topgg-webhook-docs.md

Last active February 22, 2025 11:42
Show Gist options
  • Save mezotv/5337fb7b045cd2099e914c0f5db14aaa to your computer and use it in GitHub Desktop.
Save mezotv/5337fb7b045cd2099e914c0f5db14aaa to your computer and use it in GitHub Desktop.
Download ZIP
Top.gg Webhook Documentation
Raw
topgg-webhook-docs.md

Top.gg Webhook Documentation

The current documentation is outdated and no longer accurate.

Data Format

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

Field Type Description
bot snowflake Discord ID of the bot that received a vote.
entity? snowflake Discord ID of the entity that received a vote. (Only in actual vote payloads)
user snowflake Discord ID of the user who voted.
type string The type of the vote (should always be "upvote" except when using the test button it's "test").
isWeekend boolean Whether the weekend multiplier is in effect, meaning users votes count as two.
query? string Query string params found on the /bot/:ID/vote page. Example: ?a=1&b=2.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment