Slack (for Workspace)

Slack is a cloud-based proprietary instant messaging platform developed by Slack Technologies.

These integration instructions are for users integrating with Slack at a workspace level.

Information Stored
Minimum Permissions Required
Authentication Method
Credentials Required
License Types
Integrating Slack (for Workspace) with SaaS Management
API Endpoints

Information Stored

The following table describes the available integration tasks and stored data.

Available Integration Tasks

Integration Task

Information Stored

Application Roster

User ID
Email
First Name
Last Name
License Type
Billable Status

Application Access

Last Login
User ID

License Differentiation

For details, see License Types and Tracking Application Activity by License Type for License Differentiation.

Note:The information stored is subject to change as enhancements are made to the product.

Minimum Permissions Required

Minimum API required permissions are based on the Scopes Required and API Endpoints.

Scopes Required

Scopes Required

Scopes Required

Description

Integration Task Name

Admin

It allows access to team.accessLogs API. For details, refer to Slack’s Scopes and Permissions.

Application Access

users:read

This scope is required to retrieve all the users from Slack Workspace. For details, refer to Slack’s Scopes and Permissions.

Application Roster

users:read:email

This scope is required to access the email field of the user. users:read is no longer a sufficient scope for this data field. For details, refer to Slack’s Scopes and Permissions.

Application Roster

User Role

User Role

User Role

Description

Workspace Admin

Workspace Admin permission is required to grant the above scopes during the integration authorize flow. For details, refer to Slack’s Types of Roles.

Authentication Method

OAuth2 with Authorize Flow. For details, refer to the Slack instructions Using OAuth 2.0.

Credentials Required

Workspace URL
Username
Password

Note:Username and Password are required only for authorization. These values are not stored in SaaS Management.

License Types

Slack has a Fair Billing Policy where only “Active” members are billed. This information is available via the Billable Info API. The following Slack license types are displayed in the Activity tab:

Free
Billable

Integrating Slack (for Workspace) with SaaS Management

To integrate Slack (for Workspace) with SaaS Management, obtain the following.

To integrate Slack (for Workspace) with SaaS Management:

1. Obtain your Slack Workspace URL, which is the same URL you use to sign in to your Slack account. You can also find the Workspace URL from your portal.
a. Sign in to your Slack account as a Workspace Admin.
b. Click the drop-down menu beside the organization name. The field with the format XYZ.slack.com gives the Workspace URL.
2. In SaaS Management, add the Slack application. Refer to Adding an Application.
3. Click Authorize, which redirects you to the Slack portal.
4. In the Slack portal, enter your Workspace URL.
5. Sign in with Workspace Admin credentials.
6. In the Slack (for Workspace) Permissions requested window, click Allow to authorize.
7. For further information on optimizing your organization’s Slack (for Workspace) licenses, refer to Tracking Application Activity by License Type for License Differentiation.

API Endpoints

Application Roster

https://slack.com/api/users.list

 

https://slack.com/api/team.billableinfo

Application Access Events

https://slack.com/api/team.accessLogs