# 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:
<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
- Contact email@example.com to enable the discovery:* scopes for your Slack developer app.
- Slack admins connecting their account require Slack Enterprise. They must also send an email to firstname.lastname@example.org requesting the Discovery APIs to be enabled for their enterprise.
Please contact us at email@example.com with any questions you may have. We'd be happy to help you get set up.