Webex 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 spaces/direct messages in which the app is an member. If the Mio app is not in the conversation, it won't be able to view any of its contents.

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

spark:messages_read

Read the content of rooms that you’re in

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

spark:people_read

Read your company directory

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

spark:teams_read

List the teams you are a member of

Allows us to know what teams are available to create channels in

spark:rooms_read

List the titles of spaces that you are in

Allows us know what channels are available, so we can offer to convert them to a universal channel

spark:memberships_write

Invite people to rooms on your behalf

Allows us to add the bot to channels that you want to sync

spark-admin:organizations_read

Access to read your user's organizations

Allows us to read company information so we know its name, and can identify people from the same company

Connect Platforms scopes

These are the scopes requested if you are using Connect Platforms to sync your organization's internal teams.

OAuth Scope

Description

Use Case

spark:messages_read

Read the content of rooms that you’re in

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

spark:messages_write

Post and delete messages on your behalf

To let the Service User post messages from other platforms to Webex

spark:people_read

Read your company directory

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

spark:teams_read

List the teams you are a member of

To know what teams are available to create channels in

spark:rooms_read

List the titles of spaces that you are in

To know what channels are available, so we can offer to convert them to a universal channel

spark:memberships_read

List people in the rooms you are in

To import channel membership to our database so the "members" command shows accurate membership on all connected platforms

spark:memberships_write

Invite people to rooms on your behalf

To add the bot to channels that you want to sync

spark:team_memberships_read

List the people in the teams your user belongs to

To import all members of a selected team

spark:team_memberships_write

Add people to teams on your users' behalf

To add users to a team on your behalf

spark-admin:organizations_read

Access to read your user's organizations

To read company information so we know its name, and can identify people from the same company


Frequently asked questions

Why does Mio need access my company directory?

Mio needs to access your company directory to read your name, profile picture, and email to create your account and translate your messages to other platforms seamlessly.

Mio does not need to access this information about all users, just the ones in a synced channel. The only information about users that is stored are users who are members of synced channels.

Why does Mio need the titles of spaces that I'm in?

The Mio app has a feature that allows you to convert any Webex space into a cross-platform synced channel. This is the only time the Mio app needs the information about your spaces.

What kind of actions does Mio perform on my behalf?

The Mio app only performs actions such as creating and deactivating synced channels, and inviting users to those channels.


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?