# Webhook or Watcher

Use this page if you just need the fast answer.

{% hint style="danger" %}
As of v0.6.3, legacy webhooks are deprecated. They are not maintained or supported. Use **Watcher** instead.
{% endhint %}

Scrobbling has two modes:

* **Watcher** — recommended
* **Webhooks** — legacy only

### Use Watcher when

Choose **Watcher** if you want the supported path.

It is the right choice for almost everyone.

Why:

* More reliable than legacy webhooks
* Supports multiple routes and profiles
* No Plex Pass required
* No Emby Premiere required

{% hint style="info" %}
You cannot enable **Watcher** and **Webhook** at the same time. Pick one mode.
{% endhint %}

Guide: [Watcher](/crosswatch/scrobble/watcher.md).

### Use Webhooks only when

Choose **Webhooks** only if you still depend on the old webhook flow.

Limits:

* Deprecated and unsupported
* More fragile around HTTPS and reverse proxies
* Best treated as a compatibility path only

Guide: [Webhooks (legacy)](/crosswatch/scrobble/webhooks.md).

### Quick decision

* Want the supported setup: use [Watcher](/crosswatch/scrobble/watcher.md)
* Want the overview and setup order: use [Scrobble](/crosswatch/scrobble.md)
* Need the legacy endpoint details: use [Webhooks (legacy)](/crosswatch/scrobble/webhooks.md)

### TLS note

{% hint style="warning" %}
If you expose webhook endpoints over `https://...`, use a publicly trusted certificate.

Self-signed certificates commonly break webhook delivery.
{% endhint %}

### Related topics

* [Scrobble](/crosswatch/scrobble.md) — overview and setup flow
* [Watcher](/crosswatch/scrobble/watcher.md) — recommended mode
* [Webhooks (legacy)](/crosswatch/scrobble/webhooks.md) — deprecated compatibility mode
* [Reverse proxies](/related-information/reverse-proxies.md) — webhook and WebSocket proxy rules


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.crosswatch.app/getting-started/first-time-setup/what-do-you-need/webhook-or-watcher.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.