Copy your device-based or user-based webhook URL from LunaSea
Setup the Webhook
Open Tautulli's web GUI, open the Settings and enter the "Notification Agents" page. Hit the "Add a new notification agent" button to add a new agent, and select "Webhook". Please follow each tab below to setup the webhook:
Paste the full device-based or user-based URL that was copied from LunaSea.
Each webhook can support a single user-based or device-based webhook URL. Attaching multiple device-based or user-based webhooks to a single Sonarr instance requires setting up multiple webhooks.
Keep the method on "POST". Changing the method to "PUT" will cause the webhooks to fail.
An optional description for the webhook to help identify the webhook in the list of notification agents.
Select which events should trigger a push notification. The following triggers are supported:
Transcode Decision Change
User Concurrent Streams
User New Device
Plex Server Down
Plex Server Back Up
Plex Remote Access Down
Plex Remote Access Back Up
Plex Update Available
Tautulli Update Available
Tautulli Database Corruption
You can optionally add conditions that must be met for the webhook notifications to trigger.
You can set as many conditions as you like, and can combine different conditions for different triggers by adding separate webhooks to Tautulli.
The following two sections apply to every trigger, and needs to be completed for each trigger being used. If the trigger is not being used in this notification agent, you do not need to fill in the data.
Each trigger has a specific JSON data payload that must be included in the request.
Go to the list of JSON data payload templates here.
Open the template that matches the trigger being added.
Copy the JSON data and paste it into the JSON data section for the trigger (You can hit the "Raw" button on GitHub to easily copy the entire JSON payload).
This step is only required if you are not using the default LunaSea profile (default). LunaSea will assume the default profile when none is supplied.
Correctly setting up this field is critically important to get full deep-linking support.
To attach your profile to the webhook, we need to manually create the JSON headers that will include the authorization header. This header will only contain the name of your profile, and no private information.
The username field should be an exact match to the profile that this module instance was added to within LunaSea. Capitalization and punctuation does matter.
The password field should be kept empty.
Copy the generated authorization header afterAuthorization: .
Get the template JSON headers and follow the instructions to insert the generated header into the template.
Copy and paste the template (ensure you copy below the line specified in the file) into each trigger's JSON headers area that is used within this webhook.
Attach Images to Notifications
Unlike other modules, in order to receive images (posters, etc.) along with the notification, you will need to setup an image host within Tautulli. This step is optional and not required, but recommended.
Go to Tautulli's web GUI
Open the Settings, enter "3rd Party APIs"
Select any of the available image providers
Note: If selecting Self-hosted on public domain, ensure that the image path (/tautulli/image) is publicly accessible from the internet
Enter and save the acquired API/Client ID information
Advanced: Custom Notification Body
Each notification trigger has a default notification body that matches the built-in Discord notification agent messages. This step is optional and is not required.
Each notification trigger has support for having a custom notification body for that trigger. You must still use the template JSON data as explained above, but you can enter in your custom message into the empty message key in the JSON payload. You must not delete the event_type key that is in the template, else the notification will fail.
Use the notification parameters as explained at the top of the "Data" tab in the dialog within Tautulli to build your customized notification body.