> For the complete documentation index, see [llms.txt](https://docs.discordbotlist.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.discordbotlist.com/vote-webhooks.md).

# Vote Webhooks

Vote webhooks are fired whenever a user upvotes your bot. This can be configured in bot settings.

It is advised to implement vote webhooks in your bot, as more votes brings higher rankings on our site.

## Upvote

<mark style="color:green;">`POST`</mark> `https://your-api.com/your-webhook-url`

This request is made to your API when an upvote is made.

#### Headers

| Name          | Type   | Description        |
| ------------- | ------ | ------------------ |
| Authorization | string | The webhook secret |

#### Request Body

| Name     | Type    | Description                         |
| -------- | ------- | ----------------------------------- |
| admin    | boolean | If the user is a site administrator |
| avatar   | string  | The avatar hash of the user         |
| username | string  | The username of the user who voted  |
| id       | string  | The ID of the user who voted        |

{% tabs %}
{% tab title="200 " %}

```
N/A
```

{% endtab %}
{% endtabs %}