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

Scopes and permissions

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

Scope Description Tokens
admin

Administer your workspace

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

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

user
chat:write:user

Send messages as you

user
client

Receive all events from a workspace in realtime

user legacy
commands

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

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

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

View your workspace's custom emoji

user workspace
files:read

View files, their comments, and uploading and sharing history

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

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

user workspace
links:write

Add link previews to messages

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

user bot workspace
pins:read

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

user workspace
pins:write

Pin a message or file, and remove pinned items

user workspace
post

Post messages to a workspace

user legacy
reactions:read

View your workspace's content with emoji reactions

user workspace
reactions:write

Add and remove emoji reactions

user workspace
read

Access all content in a workspace

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

View your workspace or organization's name, email domain, and icon

user workspace
tokens.basic

execute methods without needing a scope

user bot workspace
usergroups:read

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

user workspace
usergroups:write

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

user workspace
users.profile:read

Access your profile and your workspace’s profile fields

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

user workspace
users:read.email

View your workspace members' email addresses

user workspace
users:write

Change your profile information

user