TibiaWatch
Developer Tools

API & Integrations

Connect TibiaWatch with your favorite tools or build custom integrations with our powerful REST API. Automate workflows and extend functionality.

API DocumentationIntegration Guide
Pre-Built
Discord, Telegram, Zapier
Webhooks
Custom HTTP callbacks
REST API
Full programmatic access

Pre-Built Integrations

Discord Integration
Post alerts to Discord channels with rich embeds
  • Rich embed messages with character details
  • Role mentions for critical alerts
  • Automatic thread creation
  • Custom webhooks per server
Pro/Guild
Telegram Bot
Receive alerts and control tracking via Telegram
  • Direct messages or group chats
  • Bot commands to check status
  • Inline buttons for quick actions
  • Markdown formatting support
Pro/Guild
Zapier Integration
Connect to 1000+ apps without code
  • Log events to Google Sheets
  • Create Trello cards for alerts
  • Send Slack messages
  • Update Notion databases
Pro/Guild
Custom Webhooks
HTTP callbacks to your own endpoints
  • POST JSON payloads to any URL
  • Custom headers and authentication
  • Retry logic with exponential backoff
  • Webhook delivery logs
Pro/Guild

REST API

Complete API Access
Full programmatic control of your account
  • RESTful API with JSON responses
  • OpenAPI/Swagger documentation
  • 1000 requests/hour rate limit
  • Pagination for large datasets
Authentication
Secure API access with JWT tokens
  • JWT bearer token authentication
  • API keys for server-to-server
  • Scoped permissions per key
  • Revoke keys instantly
Example API Request
Get a list of tracked characters
curl -X GET "https://api.tibia.watch/api/v1/characters" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json"

// Response
{
  "data": [
    {
      "id": "uuid",
      "name": "Character Name",
      "world": "Gladera",
      "level": 425,
      "vocation": "Elite Knight",
      "isOnline": true,
      "lastSeen": "2026-01-03T10:30:00Z"
    }
  ],
  "meta": {
    "total": 42,
    "page": 1,
    "limit": 20
  }
}

Available Endpoints

Characters

CRUD operations for tracked characters

/api/v1/characters
Alerts

Manage alerts and notifications

/api/v1/alerts
Lists

Create and manage character lists

/api/v1/lists
Analytics

Retrieve analytics and statistics

/api/v1/analytics
Webhooks

Configure webhook integrations

/api/v1/webhooks
Events

Query historical events

/api/v1/events
Start Building with Our API
API access available on Guild plans
View API DocsUpgrade to Guild