Skip to content
/en/developers/vote-reward

For developers: vote rewards

How to receive players’ votes on your server and give rewards automatically. Set it up in the owner cabinet, «Vote rewards».

Webhook

For every vote with a nickname for your server we send a POST with JSON (fields below). The signature is in the X-Mmohub-Signature header: sha256= and the HMAC-SHA256 of the body with your secret key. Answer 2xx and the vote is marked «delivered». On an error we retry after 1, 10 and 30 minutes. https addresses only; redirects aren’t followed.

Request body (POST, JSON)
{
  "id": 81234,
  "project": "veloria",
  "server": "veloria-x50",
  "nickname": "DarkElfRogue",
  "votedAt": "2026-09-25T14:31:18+03:00"
}

API

If a webhook doesn’t suit you, choose «API»: pull new votes with a GET request and mark the rewarded ones with a POST. Send the key in the Authorization: Bearer header.

Pulling votes (the «API» method)
GET  https://mmohub.gg/api/v1/rewards/votes?server=<slug>&after=<id>
POST https://mmohub.gg/api/v1/rewards/votes/<id>/delivered?server=<slug>
Authorization: Bearer <key>

Manually

The «Manually» method is a CSV export of a day’s votes from the cabinet.

Security

Check the signature of every request and never give a reward twice for one id. A vote with test: true is a test from the cabinet — don’t reward it. You can replace the key in the cabinet at any time.

Set up the reward →
Still have a question? Write to us