Set up an OAuth 2.0 connection to Slack

Stephen Brandt

Updated September 27, 2024 16:12

Slack is a messaging app for the workplace. It helps you to work in a more connected, flexible, and inclusive way.

Slack documentation: API guide, Authentication

A. Set up a Slack connection

Start establishing a connection to Slack in either of the following ways:

From the Resources menu, select Connections. Then, click + Create connection at the top right.
– or –
While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination.

In the resulting Application list, select Slack.

The Create connection panel opens with required and advanced settings.

B. Provide required Slack application details

At this point, you’re presented with a series of options for providing Slack authentication.

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing.

Authentication type (required): Select OAuth 2.0 from the list. (The legacy Slack token API connection is documented separately.)

Configure scopes (required): Scopes are permissions that the Slack API defines to limit access to your account. To select the scopes for this connection,

Note: The scopes selected in the Configuration scopes section request permissions for your app's bot user. If you require a user token (to work directly on behalf of your workspace members), select the required user scopes in the user_scope section.

Click Configure scopes.
To access all of the scopes in the API, click the » button.
– or –
Check the scopes you want to add, and click the > button.
Click Save when you’re ready to leave the editor and finish setting up your connection.

User scope: User scopes are permissions that allow you to work directly on behalf of your workspace members. For more information on user scopes, see User tokens.

To select the user scope(s) for this connection,

Click user_scope.
Select the required scope(s) and click Done.

C. Edit advanced Slack settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Slack connection.

Borrow concurrency from (optional): Select another connection from the list....

NOTE: Selecting another app changes form...

Concurrency level (optional): Up to 25 allowed....

D. Save and authorize

To save and authorize the Slack connection:

Click the Save & authorize button to commit your changes and proceed to sign in with Slack.
Enter your workspace's Slack URL.
Click Continue.

Review the permissions.
In the Where should integrator.io post? section, from the Search for a channel drop-down, select the required channel to post the app.

Notes:

To configure the Slack connection in integrator.io, you have to use an existing app or install a new app to generate the OAuth tokens. For more information on how to create an app, see Create an app and retrieve OAuth token in Slack.
The app that you have created should be reviewed or approved by Slack. For more information on how to manage apps and workflows, see Manage app approval for your workspace.

Click Allow to grant permission and establish the connection.

Once you have confirmed the connection in Slack, close the browser window to return to integrator.io. The new connection will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.