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.

Save changes often. Most settings do nothing until you click the red floating Save button.

What it does (legacy)

• Receives events on these endpoints:

  • Plex: http://<host>:8787/webhook/plextrakt?uniqueID

  • Jellyfin: http://<host>:8787/webhook/jellyfintrakt?uniqueID

  • Emby: http://<host>:8787/webhook/embytrakt?uniqueID

• Can auto-remove movies from watchlists after completion (if enabled).

• Can send ratings to Trakt for Plex only (if enabled).

Webhook endpoints are protected by a unique URL token (?uniqueID) generated by CrossWatch.

Copy the full URL from Settings → Scrobble → Webhook.

You can rotate (regenerate) these tokens from Settings → Scrobble → Watcher.

If you regenerate webhook tokens, old webhook URLs stop working.

Paste the new URLs into Plex/Emby/Jellyfin after rotating.

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

1

Enable webhook mode in CrossWatch

1. Open Settings → Scrobble → Webhook.

2. Enable Webhook.

3. Copy the endpoint URL(s) shown in the UI.

2

Configure your server

Pick your server below and paste the matching URL.

Plex webhook

• Endpoint: http://<host>:8787/webhook/plextrakt?uniqueID

• Configure in Plex: Plex Account → Webhooks

• Plex Pass is required.

Jellyfin webhook

Requires the Jellyfin Webhook plugin.

• Endpoint: http://<host>:8787/webhook/jellyfintrakt?uniqueID

• Suggested 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/embytrakt?uniqueID

• Suggested 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.

Related topics

• Use the supported path instead: Watcher

• Understand the scrobble pipeline: Scrobble

• Reverse proxy notes for /webhook/*: Reverse proxies

Next steps

• Use the supported path instead: Watcher

• Understand the scrobble pipeline: Scrobble

• Configure proxy pass-through for /webhook/*: Reverse proxies