• Read through the main Notifications page
  • Copy your device-based or user-based webhook URL from LunaSea

Setup the Webhook

In Lidarr's web GUI, head to Settings -> Connect, hit the "+" button to add a new connection and select "Webhook". Please follow each section below to setup the webhook:
Select any name, for example "LunaSea".
Select which events should trigger a push notification. The following triggers are supported:
On Grab
On Release Import
On Upgrade
On Download Failure
On Import Failure
On Rename
On Track Retag
On Application Update
On Health Issue
Include Health Warnings
You can optionally select a tag that must be attached to an artist for the webhook to get triggered.
This can be useful when working with a large media collection to only receive notifications for content you are actively monitoring.
If you want to receive notifications for all artists, leave the tags area empty.
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 Lidarr instance requires setting up multiple webhooks.
Keep the method on "POST". Changing the method to "PUT" will cause the webhooks to fail.
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.
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.
Leave the password field empty. Setting this field will currently have no effect.
Once setup, close LunaSea and run the webhook test in Lidarr. You should receive a new notification letting you know that LunaSea is ready to receive Lidarr notifications!


An example Lidarr webhook can be seen below:
  • No tags are set for this webhook, meaning all artists will trigger a notification.
  • This is a user-based notification webhook, meaning it will be sent to all devices that are linked to the user ID 1234567890.
  • The webhook is associated with the profile named My Profile.