Skip to main content
This guide shows you how to register your own app with Slack to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Slack workspace.
1

Create a developer account

Go to Slack Developer Program signup page and click Join the Program.
2

Create & configure a Slack app

  1. Click on the Your Apps button then Create New App.
  2. Choose how you’d like to configure your app’s scopes and settings. You can use a manifest file or start from scratch; for a simpler flow, select From scratch.
  3. Add your App name and select a workspace to develop your app in, then click Create App.
  4. In the Basic Information tab, copy your app’s Client ID and Client Secret, as you’ll need them when configuring your integration in Nango.
3

Set up the OAuth scopes

  1. In the left sidebar, select the OAuth & Permissions tab and configure the following Redirect URL: https://api.nango.dev/oauth/callback.
  2. Still in the OAuth & Permissions tab, under Scopes, add the scopes that are relevant to how you want to consume Slack’s API. There are 2 types of scopes, Bot Token Scopes and User Token Scopes.
  • Bot tokens represent a bot associated with an app installed in a workspace. They govern what your app can access. They will be added to Nango when creating a Slack integration.
  • User token Scopes access user data and act on behalf of users that authorize them. They will be added to Nango when creating a Slack connection.
4

Create a Slack Developer Sandbox (Optional)

If you don’t have a Slack Developer Sandbox already, head over to Slack’s Developer Program dashboard and provision one to test your integration.
5

Next

Follow the Quickstart.
For more details on Slack’s OAuth implementation, see Slack’s OAuth documentation.