OopsPlayer
OopsPlayerDocumentsEmby new media notifications

Server admin guide · Emby

New media push notifications for Emby server admins

Help your Emby subscribers keep up with the shows they follow. When you add a new episode of a series they have added to Favorites, OopsPlayer can send them a push notification with the episode title and artwork. This guide shows you how to set it up in about five minutes.

For Emby server admins · English · 2026-09-24

What your subscribers see in OopsPlayer

When you add a new episode of a series in a subscriber’s Favorites, they can receive an OopsPlayer notification with the episode title and artwork. Here is what that looks like on an iPhone.

iPhone showing an OopsPlayer new media push notification with the episode title and artwork
An example notification for a newly added episode on an iPhone. The language and artwork depend on the device and media metadata.

Before you start

Have your Emby administrator login, the server address you give your subscribers, and a Telegram account ready. You will use @OopsMediaBot to create the webhook. The bot recommends Emby 4.8 or later.

Keep the webhook URL private. Paste it only into your own Emby notification settings; do not post it publicly or share screenshots that reveal it. The URL is hidden in the example below.

Create your private webhook with OopsMediaBot

The bot will generate a webhook URL for your server. You will paste it into Emby in the next step.

  1. Open @OopsMediaBot in Telegram and send /start en to switch the bot to English. Then choose + Add Emby. You can also send /new to begin a new server setup.
  2. Send the Emby server address your subscribers use, including its scheme and any port or base path, for example https://emby.example.com.
  3. Review the address and confirm that it belongs to a server you manage. If the bot cannot reach a private-network address from the public internet, follow its confirmation prompt only when the address is correct.
  4. The bot returns a unique webhook URL. Copy the entire URL for the next step.
OopsMediaBot chat showing Add Emby, server address confirmation, and a generated webhook URL with its private value hidden
The bot confirms the address and supplies the webhook. This example hides the private URL. The chat screenshot shows /start; use /start en as instructed above to select English.

Tell Emby when to notify your subscribers

Configure Emby to send the webhook whenever new media is added to your library.

  1. Sign in to your Emby server as an administrator. Open Settings → Notifications → Add Notification → Webhooks.
    Emby server Notifications settings with Add Notification menu open and Webhooks selected
    In Emby, open Notifications and choose Add Notification → Webhooks. The URL, content type, and Events fields appear in the webhook form.
  2. Give the notification a recognizable name, such as OopsPlayerNewMedia. Paste the full bot-generated URL into the URL field.
  3. Set the request content type to application/json.
  4. Scroll to Events and select Library → New media added. Leave unrelated events off if this webhook is only for new arrivals.
    Emby Add Notification form showing the webhook URL, application/json content type, Library and New Media Added events, Send Test Notification, and Add Notification button
    Check the URL and content type, enable Library → New Media Added, send a test, confirm the bot response, then select Add Notification.

Send a test, then save

  1. In the Emby webhook form, select Send test notification.
  2. Return to the Telegram chat. Wait for the bot to report ✅ Emby webhook verified. This confirms that its endpoint received the test.
  3. Return to Emby and select Add Notification at the bottom of the form to finish creating it. Do not stop after the test.

After setup, add a new episode of a series one of your subscribers has added to Favorites. Ask that subscriber to confirm the alert arrives. A successful test confirms that the webhook works; an actual episode addition checks the full path to OopsPlayer.

If your subscribers do not receive alerts

  • No bot verification: confirm that the complete webhook URL was pasted into Emby; check application/json and send another test.
  • The test passes, but a new episode generates no alert: verify that Library → New media added is selected and that you saved the notification after testing. Add a genuinely new episode to check the event.
  • Only some subscribers receive alerts: ask each subscriber to add your server in OopsPlayer, enable New Media Notifications on their own device, and allow OopsPlayer notifications in iOS Settings.
  • Series updates: confirm that your subscribers have added the shows they want to follow to Favorites in OopsPlayer.
Last updated: 2026-09-24