Articles in this section

Set up a connection to Slack

Tanisha Ray
Updated

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

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type * 

Choose your Slack API type:

  • Web methods (Web API): Send messages, manage channels, users, and files. Use this to automate common Slack tasks.

  • File upload (Web API): Upload documents, images, and code snippets. Use this to send files directly to channels or users.

  • Incoming webhooks (Events): Respond to interactive components like Slash commands.

  • SCIM: Provision and manage user accounts and groups.

API version *

Enter your Slack account API version (v1 or v2).

Auth type * 

Select your Slack account authentication type (either OAuth 2.0 or Token).

Token * (also API token for the SCIM API type)

Enter your Slack token.

Multiple layers of protection, including AES 256 encryption, are in place to keep your token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​How to retrieve token 

User scopes *

Scopes are OAuth 2.0 permissions that Slack defines to limit access to your account.

dataLoad.svg​​How to configure scopes 

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see OAuth 2.0 auth and token universal connector documentation respectively.

How to retrieve token

  1. Sign in to your Slack account.

  2. Click Your Apps and select an application.

  3. Navigate to the OAuth and Permissions tab. 

  4. Click Allow to view the token.

  5. Copy the token.

How to configure scopes

  1. Click Scope.

  2. To access all of the scopes in the API, click the » button.

    – or – 

    Check the scopes you want to add and click the > button.

  3. Click Save.

Save and authorize

  1. Click Save and authorize to commit your changes and proceed to sign in with Slack

  2. After signing in, review the permissions for the integration and click Accept.

Additional references