Troubleshooting

Common issues and solutions for VotePipe

Quick Diagnostic

Before diving into specific issues, check these common causes:

Is the provider enabled in VotePipe?
Does the webhook URL in the server list match VotePipe exactly?
Is the authentication secret/key correct (no extra spaces)?
Are you within your plan's monthly vote limit?

Votes Not Appearing

Possible Causes

1. Provider is disabled

Check the provider list in your dashboard. Ensure the provider shows as "Enabled".

2. Incorrect webhook URL

Copy the webhook URL from VotePipe and paste it exactly into your server list settings. Watch for trailing slashes or extra spaces.

3. Authentication mismatch

The authentication key/secret in the server list must match VotePipe exactly. If you're unsure, regenerate the secret in VotePipe and update the server list.

4. Vote limit reached

Check your usage in the dashboard. Votes over your plan limit are silently ignored.

Still not working? Check the provider-specific guides:

Hytale-Servers.pro•HytaleCharts•Hylist.io

Discord Notifications Not Working

Checklist

Verify the Discord webhook URL is correct and the webhook hasn't been deleted

Check that vote notifications are enabled (toggle switch in settings)

Use the Test Webhook button to verify connectivity

Ensure the webhook channel still exists in Discord

Verify votes are being received (check the Votes page first)

See the Discord setup guide for detailed instructions.

Server Callbacks Failing

Checklist

Verify your callback URL is publicly accessible from the internet

Check firewall rules allow incoming POST requests on your server

Ensure your endpoint responds within the timeout (5-30s depending on plan)

Verify the Authorization header matches your configured secret

Use the Test Callback button to send a test payload

See the callback troubleshooting guide for more help.

Authentication Errors

Provider Authentication Issues

Double-check the secret/key matches exactly (no extra spaces or line breaks)

For HMAC providers (like HytaleCharts), verify the signature algorithm matches

Regenerate the secret in VotePipe if needed, then update the server list

Tip: When regenerating secrets, update the server list immediately. The old secret stops working as soon as you regenerate.

Rate Limit Issues

Understanding Rate Limits

VotePipe has rate limits to ensure fair usage and service stability:

Tier	Limit	Applies To
Global	500/min	All API endpoints
Strict	5/min	Test webhooks, test callbacks
Heavy	10/min	Vote export, stats (trend, leaderboard, voter, provider)
Mutation	30/min	Create, update, delete, regenerate, retry
Webhooks	500/min	Incoming votes per provider
Plugin	60/min	Plugin polling per token

All endpoints within the same tier share a single counter per organization. When rate-limited, the API returns a 429 response with details:

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Maximum 5 requests per minute for this endpoint.",
    "limit": 5,
    "window_seconds": 60,
    "retry_after_seconds": 60
  }
}

If you're hitting limits, check for duplicate configurations or wait for the window to reset.

Still Need Help?

Documentation

Browse our comprehensive guides

Getting Started Guide Callback Troubleshooting Plugin Troubleshooting

Community Support

Get help from the community and team

Join Discord