Skip to main content
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions…
Dynamic Guide URL
Scopes Selected
Separator
You need Workspace Admin or App Manager permissions in your Slack workspace. Some enterprise workspaces require IT admin approval before apps can be installed.


​
Create a Slack app
Set up a new Slack application to enable bot authentication.
1
Sign in to Slack API
Sign in to the Slack API Apps page.
  • Click Create New App.
  • In the Create an app dialog, select From scratch.
2
Create new app
Fill in the application details.
  • Enter an App Name (e.g., “StackOne Bot Integration”)
  • Select your workspace from the dropdown.
  • Click Create App.
3
Copy credentials
After creating the app, you will be on the Basic Information page with the App Credentials section already visible.
  • Copy the Client ID.
  • Click Show next to Client Secret and copy the value.
  • Store both securely for use later.
  • Note: Regenerating the Client Secret later invalidates all existing refresh tokens — every connected account using this app will need to be reconnected.
4
Enable token rotation
In the left sidebar, under Features, click OAuth & Permissions. The Advanced token security via token rotation section appears at the top of the page — click Opt In.
  • A confirmation dialog titled Your app will permanently use token rotation appears. Click Opt in to confirm.
  • Required for the refresh flow — without it, no refresh token is issued. No manual install is needed; the app is installed into each end user’s workspace when they complete the OAuth flow from StackOne.
5
Add redirect URL
On the same OAuth & Permissions page, scroll to Redirect URLs.
  • Click Add New Redirect URL.
  • Enter: https://api.stackone.com/connect/oauth2/slack/callback
  • Click Add, then Save URLs.
6
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, Revoke File Public URL, Schedule Message, Send Ephemeral Message, Send Message, Set User Presence, Share File Public URL, Update Message
On the same OAuth & Permissions page, scroll to Scopes. Under Bot token scopes, click Add an OAuth Scope and add the following scopes. At least one scope is required for the app to work:


​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Slack:

1
Navigate to Connector Profiles
Login to StackOne and navigate to Connector Profiles
2
Create New Connector Profile
  • Click + Connector Profile
  • Search for and select Slack
  • Select Type as OAuth 2.0 (Bot Token)
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Bot Token Scopes (Optional)
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Slack.