# Slack permissions

> Lists the Slack bot and user OAuth scopes requested by Conclude.

Canonical HTML page: https://conclude.io/doc/developer/permissions-slack/
Last updated: 2026-02-25

---

## Slack bot token scopes

These scopes govern what the Conclude app can access in Slack.

| **OAuth Scope** | **Description** | **Use Case** |
| --- | --- | --- |
| **app\_mentions:read** | View messages that directly mention @Conclude in conversations | Allows users to interact with our app and ask it for help |
| **bookmarks:read** | List bookmarks | Conclude needs this permission to check whether a bookmark to the Conclude Dashboard exists before adding it |
| **bookmarks:write** | Create, edit and remove bookmarks | Conclude needs this permission to create bookmarks in ticket channels, so information can be found more easily |
| **channels:history** | View messages and other content in public channels that Conclude has been added to | To deliver messages and other content to Microsoft Teams |
| **channels:manage** | Manage public channels that Conclude has been added to and create new ones | To create channels for users |
| **channels:read** | View basic information about public channels in a workspace | To track Slack membership and keep the membership of the larger channel up to date |
| **chat:write** | Send messages as @Conclude | Send messages as @Conclude to channels and chats |
| **chat:write:customize** | Send messages as @Conclude with a customized username and avatar | Allows Conclude to send messages on behalf of users that do not have a Slack account |
| **chat:write:public** | Send messages to channels that @Conclude is not a member of | Allows notifications to be sent to another channel |
| **commands** | Add shortcuts and/or slash commands that people can use | Users can create channels, invite new users, ask for help, and see all members of a synced channel |
| **dnd:read** | View Do Not Disturb (DnD) settings for people in a workspace | Avoids sending alerts to people with DnD set to true |
| **files:read** | View files shared in channels and conversations that Conclude has been added to | Post files across chat platforms |
| **files:write** | Upload, edit, and delete files as Conclude | Post files from users on other chat platforms that are members of the connected channel |
| **groups:history** | View messages and other content in private channels that Conclude has been added to | To deliver messages and other content from private Slack channels to private channels in Microsoft Teams |
| **groups:read** | View basic information about private channels that Conclude has been added to | To track Slack membership and help keep the membership of the larger connected channel updated |
| **groups:write** | Manage private channels that Conclude has been added to and create new ones | To post messages from other chat platforms into private Slack channels |
| **im:history** | View messages and other content in direct messages that Conclude has been added to | To interact with users via direct message |
| **im:read** | View basic information about direct messages that Conclude has been added to | To better understand the user when interacting with the app in a direct message |
| **pins:read** | View pinned content in channels and conversations that Conclude has been added to | We pin certain header messages in channels, so users can easily see that this is a connected channel/chat |
| **pins:write** | Add and remove pinned messages and files | We pin certain header messages in channels so users can easily see that this is a connected channel/chat |
| **reactions:read** | View emoji reactions and their associated content in channels and conversations that Conclude has been added to | To enable reactions from Slack to be seen by users on Microsoft Teams |
| **reactions:write** | Add and edit emoji reactions | To add and/or edit emojis that are used by users in other chat platforms that are members of the connected channel |
| **team:read** | View the name, email domain, and icon, for workspaces that Conclude is connected to | See a list of team members |
| **usergroups:read** | View user groups in a workspace | Enables groups to be added to a chat/channel |
| **users.profile:read** | View profile details about people in a workspace | Read names and avatars of people |
| **users:read** | View people in a workspace | To identify the user that has OAuthed the Conclude app |
| **users:read.email** | View email addresses of people in a workspace | To make users unique and avoid conflicts if a user has more than one universal email across multiple workspaces |
| **users:write** | Set presence for Conclude | Set the presence for Conclude, so the team knows Conclude is available |

## Slack user token scopes

These scopes access user data on behalf of users that authorize them.

| **OAuth Scope** | **Description** | **Use Case** |
| --- | --- | --- |
| **channels:read** | View basic information about public channels in a workspace | List of channels |
| **channels:write** | Manage a user's public channels and create new ones on their behalf | Post messages to Slack channels that are sent from Microsoft Teams |
| **chat:write** | Send messages on a user's behalf | Post direct messages to Slack when sent from Microsoft Teams |
| **email** | View a user’s email address | Email addresses are used to match users in connected channels |
| **groups:read** | View basic information about a user's private channels | To track Slack membership and help keep the membership of the larger connected channel up to date |
| **groups:write** | Manage a user's private channels and create new ones on a their behalf | To post messages from other chat platforms into private Slack channels |
| **openid** | View information about a user’s identity | Used for signing into Conclude |
| **profile** | View a user’s Slack avatar and basic information in a Slack workspace | Receive basic info about a user when they sign into Conclude |

For any additional information, visit our [Security](https://conclude.io/security/) page.