Scrobbling and webhooks

Watcher configuration, runtime control, webhook delivery, and activity endpoints.

Use these endpoints for real-time playback processing.

Scrobbler configuration

Method	Endpoint	Purpose
GET	/api/scrobbler/overview	Return sources, routes, profiles, and generated URLs.
POST	/api/scrobbler/webhooks/profile	Create or update a profile webhook.
POST	/api/scrobbler/webhooks/profile/disable	Disable or remove a profile webhook.
POST	/api/scrobbler/webhooks/profile/regenerate	Regenerate a webhook token.
POST	/api/scrobbler/routes	Create a Watcher route.
PUT	/api/scrobbler/routes/{route_id}	Update a route.
DELETE	/api/scrobbler/routes/{route_id}	Delete a route.
POST	/api/scrobbler/settings	Save global scrobbler settings.

Use the generated URLs. Do not construct webhook tokens manually.

Watcher runtime

Method	Endpoint	Purpose
GET	/api/watch/status	Return Watcher route and group state.
GET	/api/watch/currently_watching	Return active playback streams.
GET	/api/watch/logs	Return selected Watcher logs.
POST	/api/watch/start	Start configured routes.
POST	/api/watch/stop	Stop all routes.
POST	/api/watch/refresh	Reload route configuration.

Inbound webhooks

Method	Endpoint	Source
POST	/webhook/plex	Plex playback.
POST	/webhook/jellyfin	Jellyfin playback.
POST	/webhook/emby	Emby playback.
POST	/webhook/plexwatcher	Plex rating events.

Webhook handlers often acknowledge events with HTTP 200, including ignored events. Inspect the JSON body for the processing result.

Legacy aliases remain available at /webhook/plextrakt, /webhook/jellyfintrakt, and /webhook/embytrakt.