Hytale-Servers.pro Integration

Learn how to receive and verify webhooks from Hytale-Servers.pro for vote notifications.

Webhook URL

Configure your webhook URL in the Hytale-Servers.pro dashboard:

https://hooks.votepipe.com/{org_slug}/hytale-servers-pro

Example: https://hooks.votepipe.com/your-org/hytale-servers-pro

Webhook Verification

Hytale-Servers.pro uses HMAC-SHA256 signatures to verify webhook authenticity. Every webhook request includes a header you can use to verify the request came from Hytale-Servers.pro.

Request Headers

Header	Description
`X-Webhook-Signature`	Hex-encoded HMAC-SHA256 signature of the raw request body
`Content-Type`	application/json

Signature Format

The signature is a hex-encoded HMAC-SHA256 hash of the raw JSON request body.

The signature is computed by:

Taking the raw JSON body as a string (exactly as received)
Computing HMAC-SHA256 of that string using your webhook secret
Encoding the result as hexadecimal

Webhook Events

Hytale-Servers.pro sends webhooks for vote events:

vote

Sent when a user votes for your server

Vote Payload Format

Hytale-Servers.pro sends vote data in the following format:

json

{
  "hytale_username": "Player123",
  "timestamp": 1767173012059,
  "server_slug": "wDFDtxbf",
  "vote_id": "604800b9-473c-40f8-bf4d-6090216e7c3f"
}

The voter name is extracted from hytale_username.

Payload Fields

Field	Type	Description
`hytale_username`	string	The Hytale username of the voter
`timestamp`	number	Unix timestamp in milliseconds when the vote occurred
`server_slug`	string	Your server's unique slug identifier
`vote_id`	string	Unique identifier for this vote (UUID format)

Setup Instructions

Step 1: Create Provider in VotePipe

Go to Add Provider and select Hytale-Servers.pro
Copy the generated webhook URL (it will look like: https://hooks.votepipe.com/your-org/hytale-servers-pro)
Keep this page open - you'll need to paste the webhook secret in the next step

Step 2: Configure Webhook in Hytale-Servers.pro

Log in to your Hytale-Servers.pro server dashboard
Navigate to Webhook Settings or Vote Settings
Generate or copy your Webhook Secret from Hytale-Servers.pro
Paste your VotePipe webhook URL in the webhook URL field
Save the webhook secret (you'll need it for the next step)

Step 3: Complete Provider Setup in VotePipe

Go back to the VotePipe provider creation page
Paste the Webhook Secret from Hytale-Servers.pro into the Auth Value field
Click Create Provider
Test the webhook from Hytale-Servers.pro to verify the connection

Important

Hytale-Servers.pro generates the webhook secret. Copy it from your Hytale-Servers.pro dashboard and paste it into the Auth Value field in VotePipe when creating the provider.

Troubleshooting

Webhook not receiving votes

Verify the webhook URL is correct in Hytale-Servers.pro settings
Ensure your provider is enabled in VotePipe
Check that the webhook secret matches exactly in both systems

Authentication errors (401)

Make sure you copied the Webhook Secret from Hytale-Servers.pro (not generated by VotePipe)
Check there are no extra spaces before or after the secret
The secret should be pasted in the Auth Value field in your VotePipe provider

Signature mismatch

The signature is computed as: HMAC-SHA256(raw_body, secret)
Ensure you're using the raw JSON body, not re-stringified JSON
Check the webhook logs in Hytale-Servers.pro to see the actual request/response

Still having issues? Check our general troubleshooting guide.

API Management

You can manage providers programmatically using the API:

→ List all providers → Regenerate provider secret → Delete a provider → View provider templates