---
title: "Slack OAuth App"
slug: "slack-oauth-app"
updated: 2025-07-13T14:50:38Z
published: 2025-07-13T14:50:38Z
canonical: "help.unleash.so/slack-oauth-app"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.unleash.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack OAuth App

1. To create a Slack OAuth App, navigate to [https://api.slack.com/apps](https://api.slack.com/apps) and create a new app.

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1726563034068.png)

1. We will create the app using a **pre-defined manifest**

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image-1726563069479.png)

1. Select the workspace where you want to create the app.

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image (40).png)

1. Use the following YAML template and replace the `redirect_urls` with the Callback URL provided by your Unleash representative:

```yaml
display_information:
  name: Unleash Integration
  description: Unleash brings you every piece of scattered data, from your cloud
    and computer, at lightning speed!
  background_color: "#8e5ec4"
  long_description: "Unleash is a productivity tool that allowing you to quickly
    search and locate all the scattered pieces of your data, across your cloud
    and local desktop. With easy searching, Unleash liberates you from the
    manual grunt work of sifting through various programs, applications, folders
    and email chains to find what you are looking for. More and more knowledge
    workers are needing a productivity tool to manage the data chaos they are
    used to and allow them to Unleash productivity.\\r

    Unleash is available via desktop and web apps, Teams and Slack bots that
    can do the following:\\r

    \\r

    * Provide /u command to search in Unleash within Slack\\r

    * Allow the ability to share a result directly in a conversation when
    searching for something using /u\\r

    * Act as a bot in a “help” channel to automatically provide suggestions
    based on the message posted"
features:
  bot_user:
    display_name: A015U4XK675
    always_online: false
oauth_config:
  redirect_urls:
    - <https://app.unleash.so/auth/assets/callback.htm>
  scopes:
    user:
      - channels:read
      - emoji:read
      - files:read
      - team:read
      - users.profile:read
      - users:read
      - users:read.email
    bot:
      - channels:read
      - groups:read
      - im:read
      - mpim:read
      - team:read
      - users:read
settings:
  org_deploy_enabled: false
  socket_mode_enabled: false
  token_rotation_enabled: false
```

1. Review all the app details, ensure the correct configuration, and then proceed to create the app.

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image (41).png)

1. After creating the app, copy the **Client ID** and **Client Secret**, store them securely, and share them with your Unleash representative.

![](https://cdn.document360.io/9c439416-8f37-43ae-8ba7-d5c31de26a65/Images/Documentation/image (42).png)