How to Set Up Plex Integration

How to Set Up Plex Integration


Plex scrobbling refers to the automatic, background tracking of the media you stream on your personal Plex Media Server. Once configured, the process is completely invisible. When you watch at least 70% of a TV episode, your Plex server automatically sends an alert to Series Reminder, updating your watch history instantly.

Because real-time webhook ingestion and episode matching require dedicated background server compute, this feature is available exclusively to members with a Supporter Subscription (starting at $20/year).

How Plex Scrobbling Works

As you watch media, your Plex Media Server generates background status events. Series Reminder listens specifically for the media.scrobble event, which signals that an episode has finished playing. When the server receives this event, it executes the following actions:

  • Auto-Add Favorites: If the TV show is not already in your Series Reminder watchlist, the system automatically adds it to your favorites. Because Supporter accounts include unlimited favorites, your watchlist expands seamlessly as you explore new series.
  • Default Notification Settings: Automatically added shows will have "Season Premiere" notifications enabled by default. If the show is already on your watchlist, your existing custom notification settings remain completely untouched.
  • TV Show Matching: Only TV series are parsed and tracked. Movies, home videos, and other media types are ignored by Series Reminder.

Setup Instructions (Step-by-Step)

To use this integration, you must have an active Plex Pass subscription, as Plex restricts custom outbound webhooks to their paid tier.

  1. Log into your Plex Account portal at plex.tv.
  2. In the top-right user menu, select Account Settings.
  3. Navigate to the left-hand sidebar and click on Webhooks.
  4. Click the Add Webhook button.
  5. Copy your unique, personal Webhook URL from the Plex Webhooks Integration page, paste it into the Plex destination field, and click save.

Once saved, your tracking is fully hands-off! Simply stream your shows on any Plex client (smart TV, Apple TV, phone, or browser), and your Series Reminder dashboard and watch history will update in real time. If you run into any issues during webhook configuration, please feel free to contact me directly for support!