top of page

Slack

 

Prerequisites

  • Before you begin, have the following ready:

    • Administrator access to an active Slack Workspace

    • Slack App OAuth (preferred) or API Key ​

​

Setup guide

Step 1: Set up Slack

The following instructions guide you through creating a Slack app. 

To create a Slack App, read this tutorial on how to create an app, or follow these instructions.

  1. Go to your Apps

  2. Click Create New App. Select From Scratch.

  3. Choose a name for your app and select the name of your Slack workspace. Click Create App.

  4. In the navigation menu, select OAuth & Permissions.

  5. Navigate to Scopes. In Bot Token Scopes, select the following scopes:

​

channels:history
channels:join
channels:read
files:read
groups:read
groups:history
links:read
reactions:read
remote_files:read
team:read
usergroups:read
users:read
users.profile:read

 

​​​

  1. At the top of the "OAuth & Permissions" page, click Install to Workspace. This will generate a Bot User OAuth Token. Copy this for later if you are using the API token for authentication.

  2. Go to your Slack instance. For any public channel, go to Info, More, and select Add Apps.

  3. Search for your newly created app. (If you are using the desktop version of Slack, you may need to restart Slack for it to pick up the new App). Add the App to all channels you want to sync data from.

 

Note:

If you are using an API key to authenticate to Slack, a refresh token is not required, as acccess tokens never expire. You can learn more about refresh tokens here.

​

 

Step 2: Integrate with LeanWorks

Share your API key with leanworks.

​

Copyright 2025 Leanworks.ai. All Rights Reserved.

bottom of page