Skip to main content
User authentication performs actions as YOU personally, not as a bot. All actions will appear as coming from your account. Your private channels, DMs, and personal data will be accessible.

​
Create a Slack app

Set up a new Slack application for user authentication.

1

Sign in to Slack API

Sign in to the Slack API Apps page.

  • Click Create New App, then 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 User Integration”)
  • Select your Development Slack 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 user 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 Users To Conversation, Leave Conversation, List Conversation Members, List Conversations, List Files, List Messages, List Scheduled Messages, 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, Set User Profile, Share File Public URL, Update Message

On the same OAuth & Permissions page, scroll to Scopes. Under User token scopes (not 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 (User Token)
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • User 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.