Skip to main content
The Discord integration connects your Sentry organization to a Discord server. It posts alert notifications to channels, supports interactive message actions, and allows you to link your Discord identity to your Sentry account.

Features

Alert notifications

Route Sentry alerts to any Discord channel based on alert rule conditions.

Interactive messages

Assign, ignore, and resolve Sentry issues directly from Discord messages.

Slash commands

Use /link, /unlink, and /help commands to manage your Sentry identity from Discord.

Bot permissions

The Sentry Discord bot requires the following permissions to function correctly:
PermissionPurpose
View ChannelsRead channel information to post messages.
Send MessagesPost alert notifications and replies.
Embed LinksRender rich embed cards for Sentry issues.
Attach FilesAttach files when needed (for example, screenshots).
Send Messages in ThreadsPost into thread channels.

Installation

1

Navigate to integrations

In Sentry, go to Settings > Integrations and find Discord in the Notifications group. Click Install.
2

Authorize the bot

Sentry redirects you to Discord’s OAuth page. Select the Discord server where you want to add the Sentry bot and click Authorize. You must have Manage Server permission on the Discord server.
3

Confirm the installation

After authorization, Sentry redirects you back and the server appears as connected. The Sentry bot is now a member of your Discord server.
The Sentry bot will only appear in channels it has been granted access to. Make sure the bot role has permission to read and write in the channels you want to use for alerts.

Setting up alert notifications

1

Open alert rules

Go to Alerts > Alert Rules and create or edit a rule.
2

Add a Discord action

Under Then perform these actions, click Add action and select Send a Discord notification.
3

Configure the action

Enter the Discord server and channel ID where notifications should be posted.
4

Save the rule

Save the alert rule. Sentry will post to the configured Discord channel whenever the rule conditions are met.
To find a channel ID in Discord, enable Developer Mode in User Settings > App Settings > Advanced, then right-click the channel and select Copy Channel ID.

Interactive message actions

When Sentry posts an alert to Discord, the message includes buttons that let you act on the issue:
ActionDescription
ResolveMarks the Sentry issue as resolved.
IgnoreIgnores the issue (mutes notifications for it).
AssignOpens a menu to assign the issue to a team member.
To use these actions, your Discord account must be linked to your Sentry account.

Slash commands

The Sentry Discord bot supports the following slash commands:
CommandDescription
/linkLinks your Discord account to your Sentry account.
/unlinkUnlinks your Discord account from Sentry.
/helpShows available bot commands.
Type /sentry link in any Discord channel where the Sentry bot is present to start the identity linking flow.

Removing the integration

Removing the Discord integration from Sentry also removes the Sentry bot from your Discord server if no other Sentry organizations are using it. To remove the integration, go to Settings > Integrations > Discord and click Uninstall.

Build docs developers (and LLMs) love