Slack scopes for Mio for internal teams
We never ask for more than the bare minimum permissions necessary
Jennifer Jin avatar
Written by Jennifer Jin
Updated over a week ago

Mio is making cross platform communication between teams a reality. In doing so, protecting the integrity and security of your data is of paramount importance to us.

Mio securely integrates with your messaging platforms and never stores messages or files. Read our security white paper for more details.

Note: Mio can only view messages in channels/direct messages in which the app is a member. If the Mio app is not in the conversation, it won't be able to view any of its contents.

This app hasn’t been reviewed or approved by Slack but we never require more permissions than necessary to make Mio function as intended.

Jump to...


Bot token scopes

These scopes govern what our Mio app can access.

OAuth Scope

Description

Use Case

app_mentions:read

View messages that directly mention @mio in conversations that the app is in

Allows users to interact with our app and ask it for help

channels:history

View messages and other content in public channels that Mio has been added to

To deliver messages and other content to other chat platforms like Microsoft Team and Webex

channels:manage

Manage public channels that Mio 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 to help keep the membership of the larger channel up to date

commands

Add shortcuts and/or slash commands that people can use

So users can create channels, invite new users, ask for help, and see full membership of a synced channel.

files:read

View files shared in channels and conversations that Mio has been added to

To post files across chat platforms

files:write

Upload, edit, and delete files as Mio

To post files from users on other chat platforms that are members of the universal channel

groups:history

View messages and other content in private channels that Mio has been added to

To deliver messages and other content from private channels to private channels in chat platforms like Microsoft Team and Webex

groups:read

View basic information about private channels that Mio has been added to

To track Slack membership to help keep the membership of the larger universal channel up to date

groups:write

Manage private channels that Mio has been added to and create new ones

To post messages from other chat platforms into Slack private channels

im:history

View messages and other content in direct messages that Mio has been added to

To interact with users via direct message

im:read

View basic information about direct messages that Mio has been added to

To better understand the user when interacting with the app in a direct message

im:write

Start direct messages with people

To send messages to the user when interacting with the app in a direct message

reactions:read

View emoji reactions and their associated content in channels and conversations that Mio has been added to

To pass those reactions from Slack to users on other platforms in the universal channel

reactions:write

Add and edit emoji reactions

To add and/or edit emojis that are passed from users in other chat platforms that are members of the universal channel

users:read

View people in a workspace

To identify the user that has OAuthed our 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 channel across multiple workspaces

User token scopes

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

OAuth Scope

Description

Use Case

users:read

View people in a workspace

To keep synced channel membership up to date in the absence of the bot token

channels:history

View messages and other content in a user's public channel

To deliver messages and other content to other chat platforms like Microsoft Teams and Webex

channels:write

Manage a user's public channels and create new ones on a user's behalf

To post messages to Slack channels when sent from Microsoft Teams, Webex, or Zoom Chat

chat:write

Send messages on a user's behalf

To post direct messages to Slack when sent from Microsoft Teams, Webex, or Zoom Chat

files:read

View files shared in channels and conversations that a user has access to

To post files across chat platforms

groups:history

View messages and other content in a user's private channels

To deliver messages and other content from private channels to private channels in chat platforms like Microsoft Teams and Webex

groups:read

View basic information about a user's private channels

To track Slack membership to help keep the membership of the larger universal channel up to date

groups:write

Manage a user's private channels and create new ones on a user's behalf

To post messages from other chat platforms into Slack private channels

im:history

View messages and other content in a user's direct messages

To interact with users via direct message

mpim:history

View messages and other content in a user's group direct messages

To deliver group chat messages and other content to other chat platforms like Microsoft Teams and Webex

mpim:read

View basic information about a user's group direct messages

To post group chat messages to Slack when sent from Microsoft Teams, Webex, or Zoom Chat

reactions:read

View emoji reactions in a user's channels and conversations and their associated content

To pass those reactions from Slack to users on other platforms in the universal channel

team:read

View the name, email domain, and icon for workspaces a user is connected to

To confirm that users belong to the team they are attempting to connect

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 channel across multiple workspaces


Frequently asked questions

Can Mio access my Slack channels that aren't synced channels?

The only permission related to viewing messages is "View messages and other content in channels/direct messages that Mio has been added to."

Mio can only view messages in channels/direct messages in which the app is a member. If the Mio app is not in the conversation, it won't be able to view any of its contents.

The app needs the ability to view the messages in your synced channel in order to post the same message on external chat apps like Microsoft Teams and Webex.

What kind of actions does Mio perform on my behalf?

The permission "Manage your public and private channels and create new ones on your behalf" allows the Mio app to:

  • Sync channels for you on your workspace

  • Invites users you to your synced channel

  • Sets the topic/purpose of the synced channel

  • Rename/archive the channel if necessary


If you have any questions regarding security for Mio, please reach out to our team via the chat bot in the bottom right corner of your page.

Did this answer your question?