Skip to main content
This token acts as your app (a bot user). Leave token rotation turned off — this authentication method has no refresh flow, so a rotating token stops working within 12 hours.

​
Create a Slack app

Create a Slack app in the workspace you want to connect.

1

Sign in to Slack

Sign in to your Slack account.

  • On the Your Apps page, click Create New App.
The Your Apps page with the Create New App button highlighted
2

Choose a blank app

In the Create new app dialog, under Or start your own way, select Blank app.

  • Click Continue.
The Create new app dialog with Blank app and Continue highlighted
3

Name the app and pick a workspace

In the Create from scratch dialog, enter the app details.

  • App name: StackOne Integration
  • Select your workspace from the Workspace dropdown.
  • Click Create. Slack opens the OAuth & Permissions page of your new app.
The Create from scratch dialog with the App name, Workspace and Create controls highlighted

​
Add scopes and install the app

Grant the scopes StackOne needs, then install the app to generate the token.

1

Add bot token scopes

Enables actions: Complete File Upload, Create Conversation, Delete File, Delete Message, Delete Scheduled Message, Get Conversation, Get File, Get File Upload URL, Get Message Permalink, Get Unified Group, Get Unified Organization, Get Unified User, Get User, Get User By Email, Get User Presence, Get User Profile, Invite Shared Conversation, Invite Users To Conversation, Join Conversation, Leave Conversation, List Conversation Members, List Conversations, List Files, List Messages, List Scheduled Messages, List Slack Connect Invites, List Thread Replies, List Unified Groups, List Unified Organizations, List Unified Users, List User Conversations, List Users, Lookup Discoverable Contact, Open Conversation, Remove User From Conversation, Rename Conversation, Schedule Message, Send Ephemeral Message, Send Message, Set User Presence, Update Message

On the OAuth & Permissions page, scroll to Scopes. Under Bot Token Scopes, click Add an OAuth Scope and add each scope StackOne needs, one at a time. At minimum add users:read, which StackOne uses to verify the connection:

The Bot Token Scopes section with the Add an OAuth Scope picker highlighted
2

Check that token rotation is off

Scroll to the top of the OAuth & Permissions page. Under Advanced token security via token rotation, the Opt In button must still be shown. Don’t click it.

  • Once turned on, token rotation cannot be turned off. If your app already uses it, create a new app instead.
The Advanced token security via token rotation section showing the Opt In button
3

Install the app

Under OAuth Tokens, click the Install to button, which is followed by your workspace name.

  • The button stays disabled until at least one scope has been added.
The OAuth Tokens section with the Install to workspace button highlighted
4

Approve the app

On the Allow the “StackOne Integration” app to access Slack page, review the permissions and click Allow.

The Slack app permission page with the Allow button highlighted
5

Copy the Bot User OAuth Token

Slack returns to OAuth & Permissions. Under OAuth Tokens, click Copy next to Bot User OAuth Token and paste it into the Bot User OAuth Token field in StackOne Hub.

  • Format: xoxb-... — a token that starts with xoxe. means token rotation is on and won’t work here
  • Treat the token like a password and store it securely. Anyone who has it can call Slack as your app.
  • If you add or change scopes later, click Reinstall to followed by your workspace name, then copy the new token.
The OAuth Tokens section with the Copy button next to Bot User OAuth Token highlighted and token values hidden

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Bot User OAuth Token
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.