---
title: "Discord"
url: https://develop.sentry.dev/integrations/discord/
---

# Discord Integration

## [Create a Discord bot](https://develop.sentry.dev/integrations/discord.md#create-a-discord-bot)

To use Sentry's Discord integration in your Sentry instance, you must first create a Discord bot. Go to the [Discord Developer Portal](https://discord.com/developers/applications) and click **New Application**.

After you create the bot, you should be redirected to its settings.

## [Update your Sentry configuration](https://develop.sentry.dev/integrations/discord.md#update-your-sentry-configuration)

Sentry needs the following Discord credentials, which you can find in the bot's settings:

* *Application ID* and *Public key* are located in **General Information**.
* *Client secret* is located in **OAuth2** > **General**.
* *Bot token* is located in **Bot**.

Add these to your Sentry instance's `config.yml` as follows:

```yaml
discord.application-id: "<application id>"
discord.public-key: "<public key>"
discord.client-secret: "<client secret>"
discord.bot-token: "<bot token>"
```

**NOTE**: If you're doing local Sentry development, you should use a tool like Ngrok to expose your local Sentry instance to the internet. Otherwise, the OAuth2 Redirect URI will not work.

After you update the `config.yml`, restart your Sentry server to continue the setup process.

## [Configure your Discord interactions endpoint](https://develop.sentry.dev/integrations/discord.md#configure-your-discord-interactions-endpoint)

Now that Sentry is running and it knows your Discord credentials, we need to set up a way for Discord to interact with Sentry.

Head back to your Discord application settings, navigate to **General Information** and look for **Interactions Endpoint URL**.

Here you'll need to enter the Discord interactions endpoint provided by Sentry:

```bash
Interactions Endpoint URL: {YOUR_DOMAIN}/extensions/discord/interactions/
```

Click **Save Changes**.

When you enter the Interactions Endpoint URL, Discord will try to verify it. The verification will fail if you haven't configured the bot credentials properly, haven't restarted your server since adding them, or don't have your server properly exposed to the internet.

## [Configure your Discord OAuth2 Redirect URI](https://develop.sentry.dev/integrations/discord.md#configure-your-discord-oauth2-redirect-uri)

Navigate to **OAuth2** > **General** and look for **Redirects**.

Here you'll need to enter the Discord setup endpoint:

```bash
Oauth2 Redirect URI: {YOUR_DOMAIN}/extensions/discord/setup/
```

Click **Save Changes**.

You're now all set to use the Discord integration in Sentry! See our [documentation on installing and configuring the Discord integration](https://docs.sentry.io/product/integrations/notification-incidents/discord/) for some next steps.