Slack
Overview
Section titled “Overview”The Slack integration connects your Slack workspace or Enterprise Grid organization to Oneleet, syncing channels, users, and guest users as assets. This enables Oneleet to monitor user access, 2FA status, and channel configuration.
What does Oneleet monitor?
Section titled “What does Oneleet monitor?”- Channels — public and private channels (excluding archived channels)
- Users — workspace members, including roles (Admin, Owner, Primary Owner) and 2FA status
- Guest users — restricted and ultra-restricted users (multi-workspace guests, single-channel guests)
To set up the Slack integration, navigate to Integrations > Add integration > Slack.
Oneleet uses OAuth to connect to the Slack API. You will first select your Slack plan type, then complete the OAuth authorization flow.
Selecting your plan type
Section titled “Selecting your plan type”Oneleet supports two Slack plan types with different permission requirements:
- Standard (Free, Pro, Business+)
- Enterprise Grid
Select the plan type that matches your Slack workspace.
Required permissions
Section titled “Required permissions”Standard plan
Section titled “Standard plan”You must be a workspace owner or administrator to authorize the integration.
Bot scopes:
users:read— read user listchannels:read— read channel informationgroups:read— read private channel informationteam:read— read workspace informationchat:write— send messages (for notifications)app_mentions:read— read app mentionsmpim:read— read multi-person DM channels
User scopes:
users:read— read user listusers:read.email— read user email addresses
Enterprise Grid
Section titled “Enterprise Grid”You must be an Organization Owner or have both Organization User Admin and Channels Admin roles.
Bot scopes: same as Standard scopes
User scopes:
users:read— read user listusers:read.email— read user email addressesadmin.users:read— read users across workspaces in the Slack Enterprise Grid organizationadmin.teams:read— read teams across workspaces in the Slack Enterprise Grid organization
Connection process
Section titled “Connection process”- Select your Slack plan type (Standard or Enterprise Grid)
- Click Connect
- You will be redirected to Slack to authorize Oneleet
- Grant the requested permissions
- Slack will redirect you back to Oneleet
Reconnecting
Section titled “Reconnecting”If you need to refresh your OAuth credentials, navigate to the integration settings, select your plan type, and click Reconnect.