> For the complete documentation index, see [llms.txt](https://wiki.crosswatch.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.crosswatch.app/crosswatch/providers/authentication/auth-trackers/auth-trakt.md).

# Auth: Trakt

Trakt is a tracker for movies and TV shows. CrossWatch connects via Trakt OAuth (client ID/secret + PIN authorization).

{% tabs %}
{% tab title="End users" %}

### What it supports

* Watchlist
* Ratings
* History

{% hint style="info" %}
Trakt is also used for scrobbling (Watcher/Webhooks) when configured.
{% endhint %}

<figure><img src="/files/Tiqq2YGyzNnKIIECzb3u" alt=""><figcaption></figcaption></figure>

### Connect Trakt

1. Create a Trakt OAuth app:
   1. Open <https://trakt.tv/oauth/applications>
   2. Click **New Application**
   3. Set **Name**: `CrossWatch`
   4. Set **Description**: `CrossWatch`
   5. Set **Redirect URI**: `urn:ietf:wg:oauth:2.0:oob`
   6. Enable permissions: `/checkin` and `/scrobble`
   7. Click **Save App**
2. Copy the **Client ID** and **Client Secret** into CrossWatch.
3. Click **Connect Trakt**. A new tab opens.

![](/files/eJ3kw6uGlf1JxvJ23lU0)

4. Enter the **PIN** shown in CrossWatch (Link code). Click **Continue**.
5. Wait until you see:

```
TRAKT authorized. You can close this tab and return to the app.
```

### Troubleshooting

* If the auth tab doesn’t open, disable popup blockers for CrossWatch.
* If the PIN fails, generate a new link code and try again.
* If Trakt connects but sync fails, re-check that your app permissions include `/scrobble`.
* If you see `429 Too Many Requests`, tune provider throttling.\
  Guide: [Provider rate limiting](/crosswatch/provider-rate-limiting.md).
  {% endtab %}

{% tab title="Power users" %}

### Config keys

Stored under:

* `trakt.*`

Common keys:

* `trakt.client_id`, `trakt.client_secret`
* `trakt.access_token`, `trakt.refresh_token`, `trakt.expires_at`

### Related docs

* Sync module: [Trakt module](/blueprint-architecture/sync/_mod_trakt.md)
* Adapter: [Adapter: Trakt](/crosswatch/providers/synchronization/adapter-trakt.md)
  {% endtab %}
  {% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/crosswatch/providers/authentication/auth-trackers/auth-trakt.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.