> ## Documentation Index
> Fetch the complete documentation index at: https://www.klavis.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Setting Up Slack OAuth App

> Complete guide to creating and configuring a Slack OAuth application

## Prerequisites

* Slack Account

## Step 1: Create Slack Developer Account & App

1. Visit [https://api.slack.com/apps](https://api.slack.com/apps)
2. On the **Your Apps** page, select **Create New App**.
3. Select **From Scratch**.
4. Enter your **App Name**.
5. Select the **Workspace** where you'll be developing your app. You'll be able to distribute your app to other workspaces later if you choose.
6. Select **Create App**.

<img src="https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step1_AppCreation.png?fit=max&auto=format&n=TEzGHGg1v0ZnLKee&q=85&s=97468698a88bc74a2b64fc7d6860ce76" alt="Slack App Creation Form" width="1302" height="657" data-path="images/knowledge-base/slack_oauth_app/step1_AppCreation.png" />

## Step 2: Configure OAuth Settings

1. Go to the **"OAuth & Permissions"** tab in your application dashboard
2. Add redirect URLs: `https://api.klavis.ai/oauth/slack/callback`
3. Click **"Save URLs"**

Here is an example of Klavis AI OAuth app configuration:

<img src="https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step2_redirect.png?fit=max&auto=format&n=TEzGHGg1v0ZnLKee&q=85&s=00e6a73aa9391b2d9c4943789579eab7" alt="OAuth Settings Configuration" width="1302" height="657" data-path="images/knowledge-base/slack_oauth_app/step2_redirect.png" />

## Step 3: Request Scopes

<Note>
  Klavis Slack MCP Server uses the following OAuth scopes:

  **Bot Scopes:** `app_mentions:read, channels:join, chat:write, im:history, reactions:read, reactions:write`

  **User Scopes:** `channels:history, channels:read, channels:write.invites, chat:write, groups:history, groups:read, groups:write.invites, im:history, im:read, im:write, mpim:history, mpim:read, mpim:write, search:read, users:read, users:read.email`
</Note>

1. Go to the **"OAuth & Permissions"** tab in your application dashboard.
2. Scroll Down to **"Scopes"**, and add scopes

<img src="https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step3_scopes.png?fit=max&auto=format&n=TEzGHGg1v0ZnLKee&q=85&s=ae2165729ae4ce2252e5f0ad16048a66" alt="Scopes Settings Configuration" width="1302" height="657" data-path="images/knowledge-base/slack_oauth_app/step3_scopes.png" />

<Check>
  You have successfully created a Slack OAuth application! You now have your Client ID and Client Secret ready for integration with Klavis AI.
</Check>

## Step 4: Configure App Distribution

1. Go to the **"Manage Distribution"** tab in your application dashboard
2. Configure your app's public distribution settings as needed

<img src="https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step4_distribution.png?fit=max&auto=format&n=TEzGHGg1v0ZnLKee&q=85&s=6787c6a9bebca25bab5cfdd4e3e6fa37" alt="Slack App Distribution Settings" width="1126" height="1062" data-path="images/knowledge-base/slack_oauth_app/step4_distribution.png" />

## (Optional) Step 5: White Labeling

<Note>
  White labeling allows you to customize the OAuth experience with your own branding instead of Klavis AI's.
</Note>

If you want to use your own Slack OAuth application with custom branding:

1. **Configure White Labeling**: Go to [https://www.klavis.ai/home/white-label](https://www.klavis.ai/home/white-label)
2. **Add Your Credentials**: Enter your Slack **Client ID** and **Client Secret**.
3. **Set Redirect URI**: Use `https://api.klavis.ai/oauth/slack/callback` or your custom callback URL
4. **Initiate OAuth**: Use your client ID when starting the OAuth flow:
   ```javascript theme={null}
   const authUrl = `https://api.klavis.ai/oauth/slack/authorize?instance_id=${instanceId}&client_id=${yourClientId}`;
   ```

<Tip>
  For detailed white labeling implementation and code examples, see our [OAuth & White Labeling guide](/auth/white-label).
</Tip>

## Resources

* [Slack Quickstart](https://api.slack.com/quickstart)
* [Klavis OAuth & White Labeling Guide](/auth/white-label)
* [Klavis White Label Dashboard](https://www.klavis.ai/home/white-label)