Webhooks
Deprecated legacy webhook setup for scrobbling (use Watcher instead).
Legacy webhooks send playback events from your media server to Trakt.
Webhooks are deprecated since v0.6.3 and are not supported.
Use the Watcher instead: Webhook or Watcher.
What it does (legacy)
Receives events on these endpoints:
Plex:
http://<host>:8787/webhook/plextraktJellyfin:
http://<host>:8787/webhook/jellyfintraktEmby:
http://<host>:8787/webhook/embytrakt
Can auto-remove movies from watchlists after completion (if enabled).
Can send ratings to Trakt for Plex only (if enabled).
If you change CrossWatch from HTTP ↔ HTTPS (or change host/port), you must update the webhook URLs in your media server.
Plex/Jellyfin/Emby will keep calling the old URL until you change it.
Prerequisites
Trakt connected in Authentication
Webhook mode enabled in Settings → Scrobble → Webhook
If you use webhooks over https://..., use a publicly trusted certificate.
Self-signed TLS certificates commonly break webhook delivery for Plex, Emby, and Jellyfin.
Use a reverse proxy with Let’s Encrypt (recommended). Keep CrossWatch on HTTP behind the proxy. See Reverse proxies.
For Jellyfin/Emby, configure user filtering in the server webhook settings.
Quick setup
Plex webhook
Endpoint:
http://<host>:8787/webhook/plextraktConfigure in Plex: Plex Account → Webhooks
Plex Pass is required.
Jellyfin webhook
Requires the Jellyfin Webhook plugin.
Endpoint:
http://<host>:8787/webhook/jellyfintraktSuggested events:
Playback Start
Playback Stop
Playback Progress (optional)
Set request header:
Content-Type: application/json
Emby webhook
Requires the Emby Webhook plugin and Emby Premiere.
Endpoint:
http://<host>:8787/webhook/embytraktSuggested events: Start, Pause, Unpause, Stop
Set request content type:
application/json
Advanced (legacy)
UI fields and behavior notes
Plex-only filters:
Username whitelist
Server UUID
Plex-only option:
Enable ratings (movies/shows/seasons/episodes)
Behavior controls:
pause debounce
suppress start near end
regress clamp
stop/pause thresholds
ID handling (legacy)
Plex: prefers GUIDs (IMDb/TMDb/TVDb). Can fall back to title+year.
Jellyfin/Emby: prefers
ProviderIds. Falls back to title+year if needed.
Summary
Legacy webhooks scrobble to Trakt only.
They’re deprecated and not maintained.
Use Watcher unless you have a hard requirement for webhooks.
Next steps
Use the supported path instead: Watcher
Understand the scrobble pipeline: Scrobble
Configure proxy pass-through for
/webhook/*: Reverse proxies
Last updated