# How to: Receive in-app notifications

Notifications are a crucial aspect of staying updated and informed about new content added to your media library. Phyn allows you to receive notifications from Jellyfin and Jellyseerr. In this walkthrough, we'll guide you through the process of configuring notifications from both Jellyfin and Jellyseerr.

{% hint style="info" %}
**Notify all devices**: This will give you a URL that can be used to notify all the devices you own that have Phyn installed. This may be useful if you use Phyn on multiple devices.

**Notify this device**: This will give you a URL that can be used to notify only the current device the URL was copied from. This is useful if you do not want to be getting notifications on multiple devices.
{% endhint %}

## Configuring Jellyfin Notifications

Phyn uses webhooks to receive notifications from Jellyfin. You can use any plugin that supports webhooks so far you use it with the default notification template.  This tutorial uses the [Jellyfin webhook plugin](https://github.com/jellyfin/jellyfin-plugin-webhook) to receive in-app notifications. The notifications are instant and non-intrusive. Follow these steps to configure the Jellyfin webhook plugin to receive notifications in Phyn:

{% hint style="info" %}
Right now, only ***item added*** and ***generic*** notifications are supported. Custom templates are not supported.
{% endhint %}

{% hint style="warning" %}
While technically, you can use Phyn with any plugin that supports webhook notifications, Phyn was only tested with the [Jellyfin webhook plugin](https://github.com/jellyfin/jellyfin-plugin-webhook) so it is the only one that is guaranteed to work. The others may or may not work correctly.
{% endhint %}

#### Getting the webhook URL

1. Open the Phyn app and navigate to ***settings***.
2. Under the notifications section, select either ***Notify all devices*** or ***Notify this device***. A URL will be copied for you. We will use this URL to configure the webhook plugin on Jellyfin.

#### Configuring the webhook plugin on Jellyfin

If you haven't already, you should install the [Jellyfin webhook plugin](https://github.com/jellyfin/jellyfin-plugin-webhook) for the next steps.&#x20;

{% hint style="info" %}
To perform these actions, you need admin access to your server. If you do not have admin access, reach out to an admin to help you out.
{% endhint %}

1. Login into your Jellyfin server on the web
2. Go to plugins -> my plugins
3. Find the Webhook plugin and click on it
4. Click on ***Add generic destination***
5. Enter the Phyn (or any name you want) in the webhook name.
6. Paste the URL copied from the Phyn app in the webhook URL.
7. Select all the notification types you want to receive. For now, it is only the ***Item added*** and ***Generic*** notification types are supported. If you would like a particular type to be added, please send an email to <support@phyn.app> or use the ***Report issue*** feature in the app.
8. Select the user under the ***User filter***. You will only get notifications from the user you select
9. Under ***Item type***, select the items you are interested in receiving notifications for.
10. <mark style="background-color:green;">Make sure you select</mark> <mark style="background-color:green;"></mark>*<mark style="background-color:green;">**Send All Properties (ignores template)**</mark>*<mark style="background-color:green;">. Phyn currently does not support custom notification templates.</mark>&#x20;
11. Click on save

Congratulations! You have successfully configured notifications from Jellyfin to Phyn.

## Configuring Notifications from Jellyseerr

Jellyseerr is another platform that you can integrate with Phyn to receive notifications effectively. Follow these steps to configure notifications from Jellyseerr:

#### Getting the webhook URL

1. Open the Phyn app and navigate to ***settings***.
2. Link your Jellyseerr account to Phyn under ***Linked services***
3. Under the ***Jellyseerr settings*** section, select either ***Notify all devices*** or ***Notify this device***. A URL will be copied for you. We will use this URL to configure the webhook notifications Jellyseerr.

#### Configuring the webhook notifications on Jellyseerr

{% hint style="info" %}
To perform these actions, you need admin access to your server. If you do not have admin access, reach out to an admin to help you out.
{% endhint %}

1. Login into your Jellyseerr server on the web
2. Go to settings -> notifications
3. On the notifications page, click on the ***Webhook*** item. It should be the last on the list. Now, this is where will will be configuring the webhook URL we got in the previous step to receive notifications.
4. Select ***Enable Agent.***
5. Paste the copied URL in the ***Webhook URL***
6. Leave ***JSON Payload*** as it is. If you have previously modified it, you can use the *reset button* below to reset it. <mark style="background-color:red;">Phyn only works with the default payload, tampering with it may make it not work properly</mark>.
7. Select the notification types you want to receive. All notification types are supported.
8. Click on Test to test the notifications. You should receive a test notification. If you don't check that the webhook URL is correct or reset the payload to default.
9. Click on save.

You have now successfully configured notifications from Jellyseerr to Phyn.

With notifications configured from both Jellyfin and Jellyseerr, you'll receive timely updates and stay informed about relevant activities within  Phyn. Enjoy your enhanced user experience!


---

# 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://docs.phyn.app/guides/how-to-receive-in-app-notifications.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.
