Vote webhook
Use this for voter rewards, role grants, or vote analytics.What Rankly sends
When a vote is processed, Rankly posts a small JSON payload to the webhook URL saved on the server. Example payload:test: true.
Set it up
1
Use a public HTTPS endpoint
Your webhook must be reachable over HTTPS. Localhost and private/internal addresses are rejected.
2
Save the URL in Rankly
Add the endpoint in your server settings, then optionally set an Authorization header if your backend expects one.
3
Send a test request
Use the dashboard test action before relying on live vote traffic.
4
Return 2xx quickly
Acknowledge the request fast and do your heavier work asynchronously.
Example receiver
Security notes
- Keep the endpoint public, but keep the processing logic private.
- Verify the Authorization header if you set one in Rankly.
- Treat deliveries as at-least-once and dedupe by
userId,serverId, andtimestamp. - Never point a webhook at localhost, a private subnet, or an internal admin panel.
Common issues
- No delivery at all: check the saved URL and whether the test request succeeds.
- 4xx response: fix your endpoint auth or JSON parsing.
- Repeated events: add deduplication before issuing rewards.
- No credits awarded: the vote may still be counted, but the payload will explain why credits were denied.
Related docs
Server Premium Webhooks
Handle signed monetization events for server premium purchases.