> ## Documentation Index
> Fetch the complete documentation index at: https://wb-21fd5541-typedoc-upgrade.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure Slack alerts

> Create and configure a Slack application to receive W&B Server alerts, notifications, and monitoring updates.

Integrate W\&B Server with [Slack](https://slack.com/) so that your W\&B instance can dispatch alerts and notifications to a Slack workspace your team already uses. This page walks W\&B Server administrators through creating a Slack application, configuring its OAuth scopes and redirect URL, and registering the application with W\&B.

<Note>
  Watch a [video demonstrating setting up Slack alerts on W\&B Dedicated Cloud deployment](https://www.youtube.com/watch?v=JmvKb-7u-oU) (6 min).
</Note>

## Create the Slack application

W\&B Server uses a custom Slack application as the bridge for delivering alerts. Follow this procedure to create that application in the Slack workspace where you want to receive notifications.

1. Visit [https://api.slack.com/apps](https://api.slack.com/apps) and select **Create an App**.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-typedoc-upgrade/s8mNwfYj0Fw6AbOj/images/hosting/create_an_app.png?fit=max&auto=format&n=s8mNwfYj0Fw6AbOj&q=85&s=dfe51b9a7dca1ac02308d4533f3dfab2" alt="Create an App button" width="1442" height="686" data-path="images/hosting/create_an_app.png" />
   </Frame>

2. Provide a name for your app in the **App Name** field.

3. Select a Slack workspace where you want to develop your app. Ensure that the Slack workspace you use is the same workspace you intend to use for alerts.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-typedoc-upgrade/s8mNwfYj0Fw6AbOj/images/hosting/name_app_workspace.png?fit=max&auto=format&n=s8mNwfYj0Fw6AbOj&q=85&s=7a800a32ccd5281d12a1bb936ba1a526" alt="App name and workspace selection" width="1160" height="1106" data-path="images/hosting/name_app_workspace.png" />
   </Frame>

## Configure the Slack application

After you create the Slack application, grant it the permissions to post messages and accept the redirect from W\&B during the OAuth handshake.

1. On the left sidebar, select **OAuth & Permissions**.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-typedoc-upgrade/s8mNwfYj0Fw6AbOj/images/hosting/add_an_oath.png?fit=max&auto=format&n=s8mNwfYj0Fw6AbOj&q=85&s=96a2687d24523351eab8c82ef8b9c9e3" alt="OAuth & Permissions menu" width="218" height="324" data-path="images/hosting/add_an_oath.png" />
   </Frame>

2. In the **Scopes** section, grant the bot the `incoming_webhook` scope. Scopes give your app permission to perform actions in your development workspace.

   For more information about OAuth scopes for bots, see [Understanding OAuth scopes for bots](https://api.slack.com/legacy/oauth-scopes) in the Slack API documentation.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-typedoc-upgrade/BYPSVyGyH9sd83MI/images/hosting/save_urls.png?fit=max&auto=format&n=BYPSVyGyH9sd83MI&q=85&s=31948b3f6872ad56ced7f88ce674d43d" alt="Bot token scopes" width="656" height="291" data-path="images/hosting/save_urls.png" />
   </Frame>

3. Configure the **Redirect URL** to point to your W\&B installation. Use the same URL that you set as your host URL in your local system settings. You can specify multiple URLs if you have different DNS mappings to your instance.

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541-typedoc-upgrade/s8mNwfYj0Fw6AbOj/images/hosting/redirect_urls.png?fit=max&auto=format&n=s8mNwfYj0Fw6AbOj&q=85&s=d72673ddb190facef7580c3a21ee8464" alt="Redirect URLs configuration" width="650" height="321" data-path="images/hosting/redirect_urls.png" />
   </Frame>

4. Select **Save URLs**.

5. Optional: Under **Restrict API Token Usage**, specify an IP or IP range to allowlist for your W\&B instances. Limiting the allowed IP address helps secure your Slack application.

## Register your Slack application with W\&B

Register the Slack application you configured with your W\&B instance so that W\&B can use it to dispatch alerts.

1. Navigate to the **System Settings** or **System Console** page of your W\&B instance, depending on your deployment.

2. Depending on the System page you're on, follow one of the following options:

   * If you're in the **System Console**: go to **Settings** then to **Notifications**.

     <Frame>
       <img src="https://mintcdn.com/wb-21fd5541-typedoc-upgrade/BYPSVyGyH9sd83MI/images/hosting/register_slack_app_console.png?fit=max&auto=format&n=BYPSVyGyH9sd83MI&q=85&s=4f7bfd7ba92f0c71d2ac9654c8a640d5" alt="System Console notifications" width="1134" height="477" data-path="images/hosting/register_slack_app_console.png" />
     </Frame>

   * If you're in the **System Settings**: toggle the **Enable a custom Slack application to dispatch alerts** to enable a custom Slack application.

     <Frame>
       <img src="https://mintcdn.com/wb-21fd5541-typedoc-upgrade/s8mNwfYj0Fw6AbOj/images/hosting/register_slack_app.png?fit=max&auto=format&n=s8mNwfYj0Fw6AbOj&q=85&s=e9ea7c5ba9bd9064cd4826827aab6b16" alt="Enable Slack application toggle" width="667" height="187" data-path="images/hosting/register_slack_app.png" />
     </Frame>

3. Supply your **Slack client ID** and **Slack secret**, then select **Save**. To find your application's client ID and secret, navigate to **Basic Information** in **Settings**.

4. To verify that everything works, set up a Slack integration in the W\&B app.

Your W\&B Server is now registered with the Slack application and can dispatch alerts to the configured Slack workspace.
