Templates Endpoint

Public

List available provider templates (no authentication required)

GET /v1/templates

Get a list of all available provider templates. This endpoint is public and does not require authentication.

Request

http

GET https://api.votepipe.com/v1/templates

No authentication required

Response (200 OK)

json

{
  "data": {
    "templates": [
      {
        "id": "1",
        "slug": "hytale-servers-pro",
        "name": "Hytale-Servers.pro",
        "description": "Hytale-Servers.pro voting integration",
        "website_url": "https://www.hytale-servers.pro/?utm_source=votepipe&utm_medium=banner&utm_campaign=partnership",
        "auth_method": "header",
        "auth_field": "Authorization",
        "default_votee_path": "username",
        "setup_instructions": "Go to your server dashboard on Hytale-Servers.pro"
      },
      {
        "id": "2",
        "slug": "hytalecharts",
        "name": "HytaleCharts",
        "description": "Official HytaleCharts.com voting integration",
        "website_url": "https://hytalecharts.com",
        "logo_url": null,
        "auth_method": "hmac",
        "auth_field": "X-HytaleCharts-Signature",
        "default_votee_path": "voter.username",
        "payload_example": {
          "event": "vote",
          "voter": {
            "username": "mrkayjaydee",
            "discord_id": "370940770225618954",
            "last_vote_at": "2026-01-05T07:06:52+00:00",
            "discord_username": "mrkayjaydee",
            "total_votes_for_server": 35
          },
          "server_id": 31,
          "timestamp": "2026-01-06T07:50:59+00:00",
          "server_name": "Mythlane",
          "server_slug": "mythlane",
          "server_stats": {
            "total_votes": 104,
            "weighted_votes": 103
          }
        },
        "setup_instructions": "Go to Server Settings > Webhooks on HytaleCharts.com"
      },
      {
        "id": "3",
        "slug": "hylistio",
        "name": "Hylist.io",
        "description": "Hylist.io server list voting integration",
        "website_url": "https://hylist.io",
        "auth_method": "hmac",
        "auth_field": "X-Hylist-Signature",
        "auth_key_source": "votepipe",
        "default_votee_path": "username",
        "setup_instructions": "Create provider in VotePipe, copy URL and secret. Add HTTP webhook in Hylist.io (Dashboard > Servers > Edit > Webhooks)."
      }
    ]
  }
}

Response Fields

Field	Type	Description
slug	string	Template identifier
name	string	Display name
auth_method	string	Authentication method (header, url_path, query, hmac)
default_votee_path	string	JSON path to extract voter name
payload_example	object	Example payload structure
setup_instructions	string	Setup instructions for the provider

Example: cURL

bash

# Get templates (no auth required)
curl -X GET https://api.votepipe.com/v1/templates

Example: JavaScript

javascript

// Get templates (no auth required)
const response = await fetch('https://api.votepipe.com/v1/templates');
const data = await response.json();

console.log(data.data.templates);

Using Templates

Templates can be used to create providers with pre-configured settings. When creating a provider, you can reference a template by its ID or slug.

To create a provider from a template, use the POST /v1/providers endpoint with the template information.