---
title: Slack Access Needs
excerpt: >-
  This Access Needs guide will walk you through getting the necessary
  credentials ready to configure your Slack Live Search connector for the
  Enterprise Search Limited Preview.
deprecated: false
hidden: true
metadata:
  title: ''
  description: ''
  robots: index
next:
  description: ''
---
# Creating a new Slack Application

We will need you to create a new Application within your enterprise Slack tenant. This application will require the following in OAuth & Permissions:

* Redirect URI — `https://{org}.moveworks.com/auth/oauthCallback`
  * This will allow Moveworks to complete the requisite oAuth2 flow and make requests on behalf of authorizing users.
* User Token Scope — `search.read`
  * This scope is required for Moveworks to make a search request to Slack on behalf of authorizing users.

To do so, you can navigate to api.slack.com, navigate to **Your Apps** and **Create New App**.

Select the “From a manifest” option

![](https://files.readme.io/1d5f5038a235585968e593871c54e1a9504f73c38ae306406744de23f43a4c86-Screenshot_2025-06-06_at_4.25.11_PM.png)

And then paste the following manifest, **ensuring that you replace the`{org}` with your Moveworks organization name. (e.g.**`https://acme.moveworks.com/auth/oauthCallback` **)**

```json
{
    "display_information": {
        "name": "Moveworks Enterprise Search"
    },
    "oauth_config": {
        "redirect_urls": [
            "https://{org}.moveworks.com/auth/oauthCallback"
        ],
        "scopes": {
            "user": [
                "search:read"
            ]
        }
    },
    "settings": {
        "org_deploy_enabled": false,
        "socket_mode_enabled": false,
        "token_rotation_enabled": false
    }
}
```

Navigate to **OAuth & Permissions** and make sure the Redirect URLs and Scopes are as specified above. Then, **Install** the application to your Workspace.

![](https://files.readme.io/c7e15de4fd3427808d67ce935280682f30d6eb97dcfb6023410d1c40da785da3-Screenshot_2025-06-06_at_4.30.00_PM.png)

Finally, navigate back to the **Basic Information**. Moveworks will need the `Client ID` and `Client Secret` for the application to configure your Live Search connection.

# Creating an HTTP Connector in Moveworks Setup

Within Moveworks Set Up, we need to create a new HTTP Connector to enable the connection, with the details from the previous step, and the fields present in the screenshot(s) below:

* Base Url — `https://slack.com/`
* Auth Config — `Oauth2`
* Oauth2 Grant Type — `Authorization Code Grant`
* Authorization URL — `https://slack.com/oauth/v2/authorize`
* Client ID — From the previous step
* Client Secret — From the previous step
* Authorization Request Query Parameters
  * `user_scope` \| `search:read`

![](https://files.readme.io/1cf94b92a23a79b24ed5f7aae68db5589c3449311cfcc02ec8e0696798fc702f-Screenshot_2025-06-09_at_11.32.38_AM.png)

Scrolling down:

* Revoke URL — `https://slack.com/api/auth.revoke`
* Revoke Access Token Options — `Revoke access token with Request Body`
* Oauth2 Token URL — `https://slack.com/api/oauth.v2.access`
* Oauth Response Type — `JSON`
* Access Token Key — `authed_user.access_token`

![](https://files.readme.io/c6d49fd35708f81cd71d79f542c6c1352f42c80cefcc10b9beb83fce02c722e5-Screenshot_2025-06-09_at_11.33.00_AM.png)

![](https://files.readme.io/ea3ed14c5f852ba5c7898ea0ab994260b8ed725dcd80e3b1b1b459726efeb032-Screenshot_2025-06-09_at_11.33.26_AM.png)

Save the configuration — we recommend using a name like `enterprise_search_slack` to keep things neat!