You must enable javascript in order to use Slack. You can do this in your browser settings.

Scopes and permissions

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

ScopeDescriptionTokens
admin

Administer a workspace

user
admin.analytics:read

Access analytics data about the organization

user
admin.apps:read

View apps and app requests in a workspace

user
admin.apps:write

Manage apps in a workspace

user
admin.barriers:read

Read information barriers in the organization

user
admin.barriers:write

Manage information barriers in the organization

user
admin.conversations:read

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

user
admin.conversations:write

Start a new conversation, modify a conversation and modify channel details

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 a workspace

user
admin.teams:write

Make changes to a workspace

user
admin.usergroups:read

Access information about user groups

user
admin.usergroups:write

Make changes to your usergroups

user
admin.users:read

Access a 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
auditlogs:read

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

user
bot

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

classic bot
calls:read

View information about ongoing and past calls

userbot
calls:write

Start and manage calls in a 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 a 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 a workspace

userbotworkspace
channels:write

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

userworkspace
chat:write

Post messages in approved channels & conversations

userworkspace
chat:write.customize

Send messages as @your_slack_app with a customized username and avatar

chat:write.public

Send messages to channels @your_slack_app isn't a member of

chat:write:bot

Send messages as your slack app

user
chat:write:user

Send messages on a user’s behalf

user
client

Receive all events from a workspace in real time

legacy
commands

Add shortcuts and/or slash commands that people can use

user
conversations:history

Deprecated: Retrieve conversation history for legacy workspace apps

workspace
conversations:read

Deprecated: Retrieve information on conversations for legacy workspace apps

workspace
conversations:write

Deprecated: Edit conversation attributes for legacy workspace apps

workspace
dnd:read

View Do Not Disturb settings for people in a workspace

userbotworkspace
dnd:write

Edit a user’s Do Not Disturb settings

user
dnd:write:user

Change the user's Do Not Disturb settings

workspace
emoji:read

View custom emoji in a 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

userworkspace
files:write:user

Upload, edit, and delete files as your slack app

userclassic bot
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 a user’s identity

legacy
identity.avatar

View a user’s Slack avatar

user
identity.avatar:read:user

View the user's profile picture

workspace
identity.basic

View information about a user’s identity

user
identity.email

View a user’s email address

user
identity.email:read:user

This scope is not yet described.

workspace
identity.team

View a 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
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

botworkspace
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 a 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 a 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 the app in a workspace

userbot
remote_files:share

Share remote files on a user’s behalf

userbot
remote_files:write

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

bot
search:read

Search a workspace’s content

user
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 a workspace

userbotworkspace
usergroups:write

Create and manage user groups

userbotworkspace
users.profile:read

View profile details about people in a workspace

userbotworkspace
users.profile:write

Edit a user’s profile information and status

user
users.profile:write:user

Change the user's profile fields

workspace
users:read

View people in a workspace

userbotworkspace
users:read.email

View email addresses of people in a workspace

userbotworkspace
users:write

Set presence for your slack app

userbot
workflow.steps:execute

Add steps that people can use in Workflow Builder

bot