Go to Slack

Scopes

Scope Short description Tokens
admin

Administer your workspace

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
channels:history

Access content in your public channels

user
channels:read

Access information about your public channels

user
channels:write

Modify your public channels

user
chat:write

post messages in approved channels & conversations

workspace
chat:write:bot

Send messages as your slack app

user
chat:write:user

Send messages as you

user
client

Receive all events from a workspace in realtime

user
commands

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

user workspace
conversations:history

use Conversations API methods that pertain to history.

workspace
conversations:read

use Conversations API methods that read messages from channels.

workspace
conversations:write

use Conversations API methods that change or write messages to channels.

workspace
dnd:read

Access your workspace’s Do Not Disturb settings

user workspace
dnd:write

Modify your Do Not Disturb settings

user
dnd:write:user

Change the user's Do Not Disturb settings

workspace
emoji:read

Access your workspace’s emoji

user workspace
files:read

Access your workspace’s files, comments, and associated information

user workspace
files:write

Add, edit, and delete files and file comments

workspace
files:write:user

Add, edit, and delete files and file comments

user bot workspace
groups:history

Access content in your private channels

user
groups:read

Access information about your private channels

user
groups:write

Modify your private channels

user
identify

Confirm your identity

user
identity.avatar

View your Slack avatar

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 the user's email address

workspace
identity.team

View your Slack workspace name

user
identity.team:read:user

View the workspace's name, domain, and icon

workspace
identity:read:user

Confirm the user's identity

workspace
im:history

Access content in your direct messages

user
im:read

Access information about your direct messages

user
im:write

Modify your direct messages

user
incoming-webhook

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

user
links:read

View some URLs in messages

user workspace
links:write

Add link previews to messages

user workspace
mpim:history

Access your group messages

user
mpim:read

Access information about your group messages

user
mpim:write

Make changes to your group messages

user
none

execute methods without needing a scope

user bot workspace
pins:read

Access your workspace’s pinned content and associated information

user workspace
pins:write

Add and remove pinned messages and files

user workspace
post

Post messages to a workspace

user
reactions:read

Access your workspace’s content with emoji reactions

user workspace
reactions:write

Modify emoji reactions

user workspace
read

Access all content in a workspace

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

Access information about your workspace

user workspace
tokens.basic

execute methods without needing a scope

user bot workspace
usergroups:read

Access basic information about your User Groups

user workspace
usergroups:write

Change your User Groups

user workspace
users.profile:read

Access your profile and your workspace’s profile fields

user workspace
users.profile:write

Modify your profile

user workspace
users.profile:write:user

Change the user's profile fields

workspace
users:read

Access your workspace’s profile information

user workspace
users:read.email

View email addresses of people on your workspace

user workspace
users:write

Modify your profile information

user