Discord Notifications

Pulsarr includes Discord integration for personalized notifications via bot DMs and channel webhooks for administrative alerts.

Quick Setup

1. Webhooks only: Create a webhook in Discord channel settings → Integrations → Webhooks, add URL to Pulsarr
2. Bot setup: Create app at Discord Developer Portal, add bot, enable Message Content Intent
3. Configure OAuth2 with bot + applications.commands scopes and required permissions
4. Invite bot to server using generated URL
5. In Pulsarr, enter Bot Token and Client ID, click Start
6. Users run /notifications to link their Plex account

Setting Up Webhooks

The webhook endpoint can be used without creating a Discord bot. This is ideal for sending administrative notifications to a specific channel.

Webhook Configuration

1. In your Discord server, create a channel for Pulsarr notifications
2. Click the gear icon beside the channel name → Integrations → Webhooks → New Webhook
3. Name the webhook "Pulsarr Notifications" and copy the webhook URL
4. Add the webhook URL to your Pulsarr configuration

You will receive notifications like this:

Multiple Webhooks

You can configure multiple Discord webhook URLs by separating them with commas. This allows you to send notifications to multiple channels or servers simultaneously.

https://discord.com/api/webhooks/id1/token1,https://discord.com/api/webhooks/id2/token2

Setting Up the Discord Bot

For personalized user notifications, you'll need to set up a Discord bot.

Creating a Discord Bot

1. Go to the Discord Developer Portal
2. Click "New Application" and give it a name (e.g., "Pulsarr")
3. Provide an icon - here's one you can use:

4. Go to the "Bot" section and click "Add Bot"
5. Under "Privileged Gateway Intents", enable "Message Content Intent"
6. Save changes and copy the bot token - you'll need this for Pulsarr

Configuring Bot Permissions

1. Go to OAuth2 → URL Generator
2. Under "Scopes", select bot and applications.commands
3. Under "Bot Permissions", select:

Permission	Required For
Send Messages	Notifications and responses
Embed Links	Rich notification embeds
Use Slash Commands	/notifications command
Send Messages in Threads	Thread support
Use External Emojis	Custom emoji display

4. Copy the generated URL

Inviting the Bot to Your Server

1. Paste the URL you copied into a browser
2. Select your Discord server from the dropdown
3. Authorize the permissions

Configuring Pulsarr Discord Bot

In your Pulsarr web interface:

1. Navigate to the Discord settings section
2. Enter the Bot Token (from step 6 above)
3. Enter the Client ID (found in the "General Information" tab of your Discord application)
4. Click the 'Start' button next to the Discord Bot Settings header

Discord Commands

Pulsarr's Discord bot provides the following slash commands:

• /notifications - Configure your notification preferences and link your Plex account

User Notification Setup

Once your bot is configured, users can set up their own notifications:

1. Users type /notifications command in your Discord server
2. They'll be prompted to enter their Plex username to create the association

3. Users can configure their notification preferences. These can be accessed anytime using the /notifications command.

note

The system uses the actual Plex username for the primary token user. When setting notification preferences, users should use their Plex username.

Notification Examples

When content is available, users will receive DMs like these:

Troubleshooting

Problem	Solution
Bot not responding	Verify bot token; enable Message Content Intent; check server permissions; review Pulsarr logs
Users not receiving DMs	Verify Plex username linked correctly; check notification settings enabled; confirm sync permissions; check Discord privacy allows DMs from server members
Webhook not sending	Verify webhook URL is correct; check channel permissions; test webhook in Discord settings

Advanced Features

For broadcasting content availability to shared channels independent of individual user watchlists, see Public Content Notifications in the Utilities section.