Tautulli Webhook Setup

Tautulli is a Plex Media Server (PMS) monitoring application. This guide shows how to configure Tautulli to send playback events to Turnstone.

Triggers to enable

In your notification agent, enable these triggers:

Playback Start
Playback Stop
Playback Pause
Playback Resume
Playback Error
Playback Buffering

JSON body template

Paste this into the JSON Data field of the Tautulli Custom Script / Webhook notification agent:

{
  "action": "{action}",
  "timestamp": "{timestamp}",
  "user": "{user}",
  "player": "{player}",
  "media_type": "{media_type}",
  "title": "{title}",
  "grandparent_title": "{grandparent_title}",
  "quality": "{quality}",
  "video_decision": "{video_decision}",
  "audio_decision": "{audio_decision}",
  "error_message": "{error_message}",
  "session_key": "{session_key}"
}

Webhook URL

http://<turnstone-host>:8534/turnstone/api/ingest/tautulli

Replace <turnstone-host> with the hostname or IP of the machine running Turnstone. (8534 is the default port; adjust if you're using a reverse proxy or changed the port)

Optional token authentication

If you set tautulli_token in Turnstone settings, every webhook request must include a matching header:

X-Tautulli-Token: <your-token>

Add this header in the Tautulli notification agent's Headers section. Requests with a missing or wrong token are rejected with HTTP 403.

Searching events

All events are stored under source tautulli and are immediately searchable in Turnstone after each webhook is received.

1.6 KiB Raw Blame History