# Kloudless API interaction

  • Connector Category: Chat
  • Unified APIs Supported: Chat, Storage, Activity, Team

# Setting up OAuth Keys for Slack

To set up OAuth keys for Slack, sign in to your Kloudless Account and expand the Slack section in the Custom OAuth keys page. Instructions are provided detailing how to set up the Slack application and the permissions needed to extend access to the Kloudless integration.

# Creating/Registering a Slack Application

Create a Slack Application. Once you have an account, you can follow Slack's OAuth guide to create an app.

# Required Scopes

These scopes will be requested for a normal (non-admin) connection:

users:read
users:read.email
users.profile:read
channels:read
channels:write
files:read
files:write:user
search:read
chat:write:user
im:read
im:write
mpim:read
mpim:write
channels:history
groups:history
groups:write
groups:read
im:history
mpim:history
usergroups:read

If you plan to use our pass-through API to access other Slack capabilities, please consider any extra scopes that may be required for those additional endpoints.

# Activity Monitoring

In order to enable activity monitoring for non-admin accounts, enable Slack's Event Subscriptions feature as described in this guide.

Add the following Request URI on your Slack app's Event Subscriptions page:

https://api.kloudless.com/services/slack/notification/<YOUR_SLACK_CLIENT_ID>

where <YOUR_SLACK_CLIENT_ID> is your Slack App's Client ID.

Note: Be sure to use the same Slack App that you used to configure Custom OAuth Keys for your Kloudless project so that Kloudless can validate webhook signatures from Slack correctly.

# Setup Admin Access for Slack

To obtain org-wide access by authenticating admin accounts using the admin Kloudless OAuth flow, request these additional Slack OAuth scopes:

auditlogs:read
discovery:read
discovery:write

Two steps are required for the discovery:read and discovery:write scopes:

  1. Contact feedback@slack.com to enable the discovery:* scopes for your Slack developer app.
  2. Slack admins connecting their account require Slack Enterprise. They must also send an email to exports@slack.com requesting the Discovery APIs to be enabled for their enterprise.

# Support

Please contact us at support@kloudless.com with any questions you may have. We'd be happy to help you get set up.