> ## 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**.

![Slack App Creation Form](https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step1_AppCreation.png?fit=max\&auto=format\&n=TEzGHGg1v0ZnLKee\&q=85\&s=97468698a88bc74a2b64fc7d6860ce76)

## 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:

![OAuth Settings Configuration](https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step2_redirect.png?fit=max\&auto=format\&n=TEzGHGg1v0ZnLKee\&q=85\&s=00e6a73aa9391b2d9c4943789579eab7)

## 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`

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

![Scopes Settings Configuration](https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step3_scopes.png?fit=max\&auto=format\&n=TEzGHGg1v0ZnLKee\&q=85\&s=ae2165729ae4ce2252e5f0ad16048a66)

> [!TIP]
>
> You have successfully created a Slack OAuth application! You now have your Client ID and Client Secret ready for integration with Klavis AI.

## 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

![Slack App Distribution Settings](https://mintcdn.com/klavisai/TEzGHGg1v0ZnLKee/images/knowledge-base/slack_oauth_app/step4_distribution.png?fit=max\&auto=format\&n=TEzGHGg1v0ZnLKee\&q=85\&s=6787c6a9bebca25bab5cfdd4e3e6fa37)

## (Optional) Step 5: White Labeling

> [!NOTE]
>
> White labeling allows you to customize the OAuth experience with your own branding instead of Klavis AI's.

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](https://www.klavis.ai/docs/auth/white-label.md).

## Resources

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.