Home Requests & Integrations Set up Jellyfin in-app notifications

Set up Jellyfin in-app notifications

Last updated on Jul 10, 2026

Set up Jellyfin in-app notifications

Use this guide to connect Jellyfin server events to Phyn. Phyn creates a notification URL for your device or account, copies that URL to your clipboard, and your Jellyfin webhook setup sends supported events to that URL.

Server admin task: The Phyn app gives you the webhook URL, but the webhook destination must be configured on the Jellyfin server. If you do not manage the server, send the copied URL to your server administrator.

Before you start

You need:

  • Phyn installed and signed in on the device that should receive notifications.
  • Notification permission enabled for Phyn on that device.
  • Phyn Premium, which is required to generate notification URLs in the current app.
  • Admin access to Jellyfin Web, or help from someone who has it.
  • A Jellyfin webhook plugin or webhook-capable notification setup on your server.

Phyn expects the default Jellyfin webhook payload. Custom payload templates may not be understood by the app.

Copy a notification URL from Phyn

  1. Open Phyn.
  2. Open the account menu.
  3. Select Settings.
  4. Find Jellyfin Notifications.
  5. Select Notify all devices or Notify this device.
  6. Read the prompt and select Copy URL.
  7. If your device asks for notification permission, allow notifications for Phyn.
  8. Paste the copied URL somewhere safe, or send it to the person who manages your Jellyfin server.

Phyn does not show the full notification URL in the app. After you select Copy URL, the URL is copied to your clipboard.

Choose Notify all devices when the same server events should notify your signed-in Phyn devices. Choose Notify this device when only the current device should receive those notifications.

Privacy note: Treat the notification URL like a private webhook address. Do not post it publicly or share it with people who do not manage your server.

Add the URL to Jellyfin

These steps use the common Jellyfin webhook flow. Exact labels can differ slightly by plugin version.

  1. Open Jellyfin Web as an administrator.
  2. Go to Dashboard.
  3. Open Plugins and confirm a webhook plugin is installed.
  4. Open the webhook plugin settings.
  5. Add a new webhook destination.
  6. Give it a clear name, such as Phyn.
  7. Paste the notification URL copied from Phyn into the webhook URL field.
  8. Select the event types you want Phyn to receive.
  9. If the plugin offers a payload or template option, use the default payload.
  10. Save the webhook destination.
  11. Send a test notification if your plugin provides a test button.

Payload warning: Avoid custom webhook templates for Phyn notifications. The app is built around the default Jellyfin webhook payload, so heavily customized payloads may arrive but not display correctly.

Expected result

After the webhook is saved, supported Jellyfin events sent to the Phyn notification URL can appear as in-app or push notifications on the selected device or devices.

If you chose Notify this device, only that device should receive the notification. If you chose Notify all devices, your signed-in Phyn devices can receive the same server notification.

If notifications do not arrive

If this happens, check these first:

  • Phyn has notification permission in your device settings.
  • The notification URL was copied completely and pasted into the webhook URL field.
  • The Jellyfin server can reach the internet address used by the Phyn notification URL.
  • The webhook plugin is enabled and saved.
  • The selected Jellyfin event type actually occurred after the webhook was configured.
  • The webhook payload is still the default payload.

If the URL was copied a long time ago or you changed devices, return to Phyn and copy the notification URL again.

Related articles