Webhooks & Event Subscriptions

PocketMC supports outgoing HTTP webhooks to deliver real-time operational notifications to Discord channels, Telegram bots, monitoring systems, or home automation webhooks.

Supported Event Types

• instance.started: Dispatched when a Minecraft server process completes bootup and binds ports.
• instance.stopped: Dispatched when a server process terminates cleanly.
• instance.crashed: Dispatched when a server exits with a non-zero exit code or detects a fatal JVM crash.
• player.joined / player.left: Triggered on player join or disconnect events with gamertags.
• backup.completed: Fired when local or cloud backup archives are finalized with SHA-256 verification.

Webhook Payload Structure

{
  "event": "backup.completed",
  "timestamp": "2026-08-24T00:00:00Z",
  "instanceId": "paper-survival",
  "data": {
    "backupId": "backup-2026-08-24-001",
    "sizeBytes": 145829104,
    "sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
    "destination": "google_drive",
    "durationMs": 4120
  }
}