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: Add Bookmark, Archive Conversation, Close Conversation, Complete File Upload, Create Canvas, Create Channel Canvas, Create Conversation, Create List, Create List Item, Create User Group, Delete Canvas, Delete Canvas Access, Delete File, Delete List Access, Delete List Item, Delete List Items, Delete Message, Delete Scheduled Message, Disable User Group, Edit Bookmark, Edit Canvas, Enable User Group, Get Canvas Content, Get Conversation, Get File, Get File Upload URL, Get List Download, Get List Item, 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 Bookmarks, List Conversation Members, List Conversations, List Files, List List Items, 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 User Group Users, List User Groups, List Users, Lookup Canvas Sections, Lookup Discoverable Contact, Mark Conversation Read, Open Conversation, Remove Bookmark, Remove User From Conversation, Rename Conversation, Schedule Message, Send Ephemeral Message, Send Message, Set Canvas Access, Set Conversation Purpose, Set Conversation Topic, Set List Access, Set User Presence, Start List Download, Unarchive Conversation, Update List, Update List Item, Update Message, Update User Group, Update User Group Members

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

Create the StackOne Connector Profile

1

Create a Connector Profile

Enable the connector and create a Connector Profile in your project. See Setup Connector Profile.
2

Link an Account

Once the Connector Profile is created, continue to link an account.