Scopes and permissions

A Slack app's capabilities and permissions are governed by named scopes and the tokens they support.

ScopeDescriptionTokens
admin

Administer the workspace

legacy
admin.conversations:read

View the channel’s member list, topic, purpose and channel name

user
admin.invites:read

Gain information about invite requests in a Grid organization.

user
admin.invites:write

Approve or deny invite requests in a Grid organization.

user
admin.teams:read

Access information about the workspace

user
admin.teams:write

Make changes to the workspace

user
admin.users:read

Access the workspace’s profile information

user
admin.users:write

Modify account information

user
app_mentions:read

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

bot
apps

Make changes to the user’s API apps

legacy
auditlogs:read

View events from all workspaces, channels and users (Enterprise Grid only)

userbot
bot

Add the ability for people to direct message or mention @your_slack_app

bot
calls:read

View information about ongoing and past calls

userbot
calls:write

Start and manage calls in this workspace

userbot
channels:history

View messages and other content in public channels that your slack app has been added to

userbotworkspace
channels:join

Join public channels in the workspace

bot
channels:manage

Manage public channels that your slack app has been added to and create new ones

bot
channels:read

View basic information about public channels in the workspace

userbotworkspace
channels:write

Manage the user’s public channels and create new ones on the user’s behalf

userworkspace
chat:write

Post messages in approved channels & conversations

botworkspace
chat:write:bot

Send messages as your slack app

userworkspace
chat:write:user

Send messages on the user’s behalf

user
client

Receive all events from the workspace in real time

legacy
commands

Add actions and/or slash commands that people can use

userbot
conversations:history

This scope is not yet described.

workspace
conversations:read

This scope is not yet described.

workspace
conversations:write

This scope is not yet described.

workspace
discovery:read

View all of the organization’s messages (including all private channels and direct messages), as well as the organization’s files

userbot
discovery:write

Make changes to the organization’s messages (including all messages in private channels and direct messages), as well as the organization’s files

userbot
dnd:read

View Do Not Disturb settings for people in the workspace

userbotworkspace
dnd:write

Edit the user’s Do Not Disturb settings

user
dnd:write:user

Change the user's Do Not Disturb settings

workspace
emails:write

Upload and modify emails on the user’s behalf

userbot
emoji:read

View custom emoji in the workspace

userbotworkspace
files:read

View files shared in channels and conversations that your slack app has been added to

userbotworkspace
files:write

Upload, edit, and delete files as your slack app

userbotworkspace
files:write:user

Upload, edit, and delete files as your slack app

user
groups:history

View messages and other content in private channels that your slack app has been added to

userbotworkspace
groups:read

View basic information about private channels that your slack app has been added to

userbotworkspace
groups:write

Manage private channels that your slack app has been added to and create new ones

userbotworkspace
identify

View information about the user’s identity

legacy
identity.avatar

View the user’s Slack avatar

user
identity.avatar:read:user

View the user's profile picture

workspace
identity.basic

View information about the user’s identity

user
identity.email

View the user’s email address

user
identity.email:read:user

This scope is not yet described.

workspace
identity.team

View the user’s Slack workspace name

user
identity.team:read:user

View the workspace's name, domain, and icon

workspace
identity:read:user

This scope is not yet described.

workspace
ifttt

Post messages to the workspace

userlegacy
im:history

View messages and other content in direct messages that your slack app has been added to

userbotworkspace
im:read

View basic information about direct messages that your slack app has been added to

userbotworkspace
im:write

Start direct messages with people

userbotworkspace
incoming-webhook

Create one-way webhooks to post messages to a specific channel

userbot
links:read

View some URLs in messages

userbotworkspace
links:write

Show previews of URLs in messages

userbotworkspace
mpim:history

View messages and other content in group direct messages that your slack app has been added to

userbotworkspace
mpim:read

View basic information about group direct messages that your slack app has been added to

userbotworkspace
mpim:write

Start group direct messages with people

userbotworkspace
none

Execute methods without needing a scope

userbotworkspace
pins:read

View pinned content in channels and conversations that your slack app has been added to

userbotworkspace
pins:write

Add and remove pinned messages and files

userbotworkspace
post

Post messages to the workspace

legacy
reactions:read

View emoji reactions and their associated content in channels and conversations that your slack app has been added to

userbotworkspace
reactions:write

Add and edit emoji reactions

userbotworkspace
read

View all content in the workspace

legacy
reminders:read

View reminders created by your slack app

userbot
reminders:read:user

Access reminders created by a user or for a user

workspace
reminders:write

Add, remove, or mark reminders as complete

userbot
reminders:write:user

Add, remove, or complete reminders for the user

workspace
remote_files:read

View remote files added by this app in the workspace

userbot
remote_files:share

Share remote files on the user’s behalf

userbot
remote_files:write

Add, edit, and delete remote files on the user’s behalf

userbot
rtm:stream

Provide your slack app with a stream of all activity in Slack for the conversations and people it can see

search:read

Search the workspace’s content

userbot
stars:read

View messages and files that your slack app has starred

user
stars:write

Add or remove stars

user
team:read

View the name, email domain, and icon for workspaces your slack app is connected to

userbotworkspace
tokens.basic

Execute methods without needing a scope

userbotworkspace
usergroups:read

View user groups in the workspace

userbotworkspace
usergroups:write

Create and manage user groups

userbotworkspace
users.profile:read

View profile details about people in the workspace

userbotworkspace
users.profile:write

Edit the user’s profile information and status

user
users.profile:write:user

Change the user's profile fields

workspace
users:read

View people in the workspace

userbotworkspace
users:read.email

View email addresses of people in the workspace

userbotworkspace
users:write

Set presence for your slack app

userbot