Skip to main content

​
Create a Slack app

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

1

Create a new app

Sign in to your Slack account. On the Your Apps page, click Create New App.

  • In the Create new app dialog, under Or start your own way, select Blank app, then click Continue.
The Create new app dialog with Blank app and Continue highlighted
2

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
3

Add the redirect URL

On the OAuth & Permissions page, scroll to Redirect URLs.

  • Click Add New Redirect URL.
  • In Redirect URL, enter the Callback URL from your Connector Profile.
  • Click Add, then click Save URLs.
The Redirect URLs section with the StackOne callback URL entered and the Add button highlighted
4

Turn on token rotation

Scroll to the top of the OAuth & Permissions page. Under Advanced token security via token rotation, click Opt In and confirm.

  • The Opt In button stays disabled until at least one redirect URL is saved.
  • Once turned on, token rotation cannot be turned off.
The Advanced token security via token rotation section with the Opt In button highlighted
5

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

Scroll to Scopes. Under Bot Token Scopes, click Add an OAuth Scope and add each scope listed.

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

Copy the Client ID and Client Secret

In the sidebar under Settings, click Basic Information. The App Credentials section is at the top of the page.

  • Copy the Client ID into your Connector Profile.
  • Click Show next to Client Secret, then copy it into your Connector Profile.
  • Note: Clicking Regenerate next to Client Secret invalidates the current secret, and every connected account that uses this app must be reconnected.
The App Credentials section with the Client ID field and the Client Secret Show button highlighted

​
Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Slack:
1

Open the connector

Log in to StackOne, open Connectors, and select Slack.
2

Choose actions and events

  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0 (Bot).
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
3

Set up authentication

  • Select Authentication Type as OAuth 2.0 (Bot).
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
    • Bot Token Scopes (Optional)
  • Click Create Profile.
Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for Slack.