Skip to main content

How to create an app and retrieve OAuth token in Slack

Naga Sri Hari Gonaboyina
  • Updated

To configure the Slack connection in integrator.io, users have to install a new app to generate the OAuth tokens (User OAuth token or Bot user OAuth token) as the existing Slack tokens are now legacy ones. This article explains how to create a Slack app, provide permissions, and generate an OAuth token.

Slack documentation: Basic app setup
Additional reference: Set up a token connection to Slack

Contents

Create an App

  1. Sign in to your Slack account.
  2. Navigate to Slack API.
  3. Click Create new app. The Create an app window appears.
  4. Click From scratch. The Name app & choose workspace window appears.
1.png
  1. Provide the App Name.
  2. From the Pick a workspace to develop your app in drop-down list, select your workspace.
  3. Click Create app. The Basic information page appears.
22.png
  1. Navigate to App-level tokens.
  2. Click Generate tokens and scopes. The Generate an app-level token window appears.
3.png
  1. Provide the Token name.
  2. Click Add scope and select the required scopes.
  3. Click Generate.
4.png
  1. Navigate to Features > Incoming webhooks and toggle On Activate Incoming Webhooks.
5.png
  1. Navigate to Features > Interactivity & shortcuts and toggle On Interactivity.
  2. Provide the required information and click Save changes.
6.png
  1. Navigate to Settings > Basic information > Install your app.
  2. Click Install to workspace.
7.png
  1. Navigate to Feature > OAuth & permissions > OAuth Tokens for Your Workspace.
  2. Click Install to workspace.
8.png
  1. In Redirect URLs, click Add new redirect URL.
  2. Provide the redirect URL (https://integrator.io/connection/oauth2callback), click Add, and click Save.
9.png
  1. In Scopes, click Add an OAuth scope and select the required scope(s) for both bot and user tokens.
10.png
  1. Navigate to Settings > Manage distribution.
  2. Verify all fields in Share Your App with Other Workspaces and click Activate public distribution.
11.png

Now the app status changes from Not distributed to Publicly Distributed and you can see it in the Your apps section.

12.png

Retrieve Slack OAuth token

  1. Sign in to your Slack account.
  2. Navigate to Slack API.
  3. Click Your apps in the top right corner and select the application.
  4. Navigate to Features > OAuth & permissions > OAuth Tokens for Your Workspace.
  5. Copy the required token (User OAuth token or Bot user OAuth token).
13.png

Related articles

Comments

2 comments

Date Votes
  • Bhushan Rane
    • Edited

    Very helpful documentation! Thanks Naga. 

    Can you please mention the IO Redirect URL on this page as well? I was able to get it from another link.

    0
  • Naga Sri Hari Gonaboyina

    Thank you, Bhushan.
    I have updated the Redirect URL. 

    0

Please sign in to leave a comment.