Go to Slack

Scopes and permissions

A Slack app's capabilities and permissions are governed by named scopes.

ScopeDescriptionTokens
admin

Administer your workspace

userlegacy
admin.users:write

Modify your account information

user
auditlogs:read

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

user
bot

Add a bot user with the username @your_slack_app

bot
calls:read

Allow apps to access information about ongoing and past Calls

user
calls:write

Allow apps to access the Calls API

user
channels:history

View messages, activity, and files in public channels

user
channels:read

View channel names, member lists, topics, purposes, and latest message

user
channels:write

Rename, archive, and change the topic and purpose

user
chat:write

post messages in approved channels & conversations

workspace
chat:write:bot

Send messages as your slack app

userworkspace
chat:write:user

Send messages as you

user
client

Receive all events from a workspace in realtime

userlegacy
commands

Add slash commands and add actions to messages (and view related content)

userworkspace
conversations.app_home:create

Direct message any members

workspace
conversations:history

View messages, activity, and files

workspace
conversations:read

View the member list and, if applicable, topic, purpose, and channel name

workspace
conversations:write

Start a new conversation and, if applicable, change the names, topics, and purposes

workspace
dnd:read

Access your workspace’s Do Not Disturb settings

userworkspace
dnd:write

Modify your Do Not Disturb settings

user
dnd:write:user

Change the user's Do Not Disturb settings

workspace
emoji:read

View your workspace's custom emoji

userworkspace
files:read

View files, their comments, and uploading and sharing history

userworkspace
files:write

Add, edit, and delete files and file comments

workspace
files:write:user

Add, edit, and delete files and file comments

user
groups:history

View messages, activity, and files in private channels

user
groups:read

View private channel names, member lists, topics, purposes, and latest message

user
groups:write

Rename, archive, and change the topic and purpose

user
identify

Confirm your identity

userlegacy
identity.avatar

View your profile picture

user
identity.avatar:read:user

View the user's profile picture

workspace
identity.basic

Confirm your identity

user
identity.email

View your email address

user
identity.email:read:user

View your email address

workspace
identity.team

View your workspace's name, domain, and icon

user
identity.team:read:user

View the workspace's name, domain, and icon

workspace
identity:read:user

Confirm your identity

workspace
im:history

View messages, activity, and files in direct messages

user
im:read

View the names of the people in DMs

user
im:write

Direct message members who use your slack app

user
incoming-webhook

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

user
links:read

View some links in messages

userworkspace
links:write

Add link previews to messages

userworkspace
mpim:history

View messages, activity, and files in group messages

user
mpim:read

View the names of the people in group messages

user
mpim:write

Start a group direct message

user
none

execute methods without needing a scope

userbotworkspace
pins:read

View pins, their associated messages and files, and other information about them

userworkspace
pins:write

Pin a message or file, and remove pinned items

userworkspace
post

Post messages to a workspace

userlegacy
reactions:read

View your workspace's content with emoji reactions

userworkspace
reactions:write

Add and remove emoji reactions

userworkspace
read

Access all content in a workspace

userlegacy
reminders:read

Access reminders created by you or for you

user
reminders:read:user

Access reminders created by a user or for a user

workspace
reminders:write

Add, remove, or complete reminders for you

user
reminders:write:user

Add, remove, or complete reminders for the user

workspace
remote_files:read

Access the workspace’s remote files added by this app, and associated information

user
remote_files:share

Allow apps to share remote files on behalf of a user

user
remote_files:write

Allow apps to add, edit, and delete remote files on behalf of a user

user
search:read

Search your workspace’s content

user
stars:read

Access your starred messages and files

user
stars:write

Add or remove stars for you

user
team:read

View the name, email domain, and icon for workspaces you‘re connected to

userworkspace
tokens.basic

execute methods without needing a scope

userbotworkspace
usergroups:read

View the names, descriptions, and members of your workspace's user groups

userworkspace
usergroups:write

Add or disable user groups, and change their names and descriptions.

userworkspace
users.profile:read

Access your profile and your workspace’s profile fields

userworkspace
users.profile:write

Change your profile fields and any data you entered in them

user
users.profile:write:user

Change the user's profile fields

workspace
users:read

View your workspace's list of members and their contact information

userworkspace
users:read.email

View your workspace members' email addresses

userworkspace
users:write

Change your profile information

user