Permission scopes

adminAdminister a workspaceUser
admin.analytics:readAccess analytics data about the organizationUser
admin.app_activities:readView execution logs within an organizationUser
admin.apps:readView apps and app requests in a workspaceUser
admin.apps:writeManage apps in a workspaceUser
admin.barriers:readRead information barriers in the organizationUser
admin.barriers:writeManage information barriers in the organizationUser
admin.conversations:readView the channel’s member list, topic, purpose and channel nameUser
admin.conversations:writeStart a new conversation, modify a conversation and modify channel detailsUser
admin.invites:readGain information about invite requests in a Grid organization.User
admin.invites:writeApprove or deny invite requests in a Grid organization.User
admin.roles:readList role assignments for your workspace.User
admin.roles:writeAdd and remove role assignments for your workspace.User
admin.teams:readAccess information about a workspaceUser
admin.teams:writeMake changes to a workspaceUser
admin.usergroups:readAccess information about user groupsUser
admin.usergroups:writeMake changes to your usergroupsUser
admin.users:readAccess a workspace’s profile informationUser
admin.users:writeModify account informationUser
admin.workflows:readView all workflows in a workspaceUser
admin.workflows:writeManage workflows in a workspaceUser
app_configurations:readRead app configuration info via App Manifest APIsUserBotConfiguration
app_configurations:writeWrite app configuration info and create apps via App Manifest APIsUserBotConfiguration
app_mentions:readView messages that directly mention @your_slack_app in conversations that the app is inLegacy botBot
apps.requests:writeCreate or cancel an App Approval request on user's behalfUser
assistant:writeAllow your slack app to act as an AI AssistantLegacy botBot
auditlogs:readView events from all workspaces, channels and users (Enterprise Grid only)User
authorizations:readGrants permission to list authorizations associated with the Events APIApp level
bookmarks:writeCreate, edit, and remove bookmarksUserLegacy botBot
botAdd the ability for people to direct message or mention @your_slack_appLegacy bot
calls:readView information about ongoing and past callsUserLegacy botBot
calls:writeStart and manage calls in a workspaceUserLegacy botBot
canvases:readyour slack app will be able to access contents of canvases created inside Slack.UserLegacy botBot
canvases:writeyour slack app will be able to create, edit and remove canvases.UserBot
channels:historyView messages and other content in public channels that your slack app has been added toUserLegacy botBot
channels:joinJoin public channels in a workspaceLegacy botBot
channels:manageManage public channels that your slack app has been added to and create new onesLegacy botBot
channels:readView basic information about public channels in a workspaceUserLegacy botBot
channels:writeManage a user’s public channels and create new ones on a user’s behalfUser
channels:write.invitesInvite members to public channelsUserLegacy botBot
channels:write.topicSet the description of public channelsUserLegacy botBot
chat:writePost messages in approved channels & conversationsUserBot
chat:write.customizeSend messages as @your_slack_app with a customized username and avatarLegacy botBot
chat:write.publicSend messages to channels @your_slack_app isn't a member ofLegacy botBot
chat:write:botSend messages as your slack appUser
chat:write:userSend messages on a user’s behalfUser
clientReceive all events from a workspace in real time
commandsAdd shortcuts and/or slash commands that people can useUserBot
connections:writeGrants permission to generate websocket URIs and connect to Socket ModeApp level
conversations.connect:manageAllows your slack app to manage Slack Connect channelsLegacy botBot
conversations.connect:readReceive Slack Connect invite events sent to the channels your slack app is inLegacy botBot
conversations.connect:writeCreate Slack Connect invitations for channels that your slack app has been added to, and accept invitations sent to your slack appLegacy botBot
conversations:historyDeprecated: Retrieve conversation history for legacy workspace apps
conversations:readDeprecated: Retrieve information on conversations for legacy workspace apps
conversations:writeDeprecated: Edit conversation attributes for legacy workspace apps
conversations:write.invitesInvite members to conversations
conversations:write.topicSet the description of conversations
datastore:readView and see data from Slack App DatastoreLegacy botBot
datastore:writeWrite data to Slack App DatastoreLegacy botBot
dnd:readView Do Not Disturb settings for people in a workspaceUserLegacy botBot
dnd:writeEdit a user’s Do Not Disturb settingsUser
emoji:readView custom emoji in a workspaceUserLegacy botBot
files:readView files shared in channels and conversations that your slack app has been added toUserLegacy botBot
files:writeUpload, edit, and delete files as your slack appUserBot
files:write:userUpload, edit, and delete files as your slack appUserLegacy bot
groups:historyView messages and other content in private channels that your slack app has been added toUserLegacy botBot
groups:readView basic information about private channels that your slack app has been added toUserLegacy botBot
groups:writeManage private channels that your slack app has been added to and create new onesUserLegacy botBot
groups:write.invitesInvite members to private channelsUserLegacy botBot
groups:write.topicSet the description of private channelsUserLegacy botBot
hosting:readView and see information about Slack appsUser
hosting:writeManage and deploy Slack appsUser
identifyView information about a user’s identityLegacy
identity.avatarView a user’s Slack avatar
identity.basicView information about a user’s identity
identity.emailView a user’s email address
identity.teamView a user’s Slack workspace name
im:historyView messages and other content in direct messages that your slack app has been added toUserLegacy botBot
im:readView basic information about direct messages that your slack app has been added toUserLegacy botBot
im:writeStart direct messages with peopleUserLegacy botBot
im:write.topicSet the description in direct messagesUserLegacy botBot
incoming-webhookCreate one-way webhooks to post messages to a specific channelUserLegacy botBot
links.embed:writeEmbed video player URLs in messages and app surfacesUserBot
links:readView URLs in messagesUserLegacy botBot
links:writeShow previews of URLs in messagesUserLegacy botBot
metadata.message:readAllows your slack app to read message metadata in channels that your slack app has been added toLegacy botBot
mpim:historyView messages and other content in group direct messages that your slack app has been added toUserLegacy botBot
mpim:readView basic information about group direct messages that your slack app has been added toUserLegacy botBot
mpim:writeStart group direct messages with peopleUserLegacy botBot
mpim:write.invitesInvite members to group direct messagesUserLegacy botBot
mpim:write.topicSet the description in group direct messagesUserLegacy botBot
noneExecute methods without needing a scopeLegacy botBot
openidView information about a user’s identityUser
pins:readView pinned content in channels and conversations that your slack app has been added toUserLegacy botBot
pins:writeAdd and remove pinned messages and filesUserLegacy botBot
postPost messages to a workspace
profileView a user’s Slack avatar and Slack workspace's basic informationUser
reactions:readView emoji reactions and their associated content in channels and conversations that your slack app has been added toUserLegacy botBot
reactions:writeAdd and edit emoji reactionsUserLegacy botBot
readView all content in a workspace
reminders:readView reminders created by your slack appUserLegacy botBot
reminders:writeAdd, remove, or mark reminders as completeUserLegacy botBot
remote_files:readView remote files added by the app in a workspaceUserLegacy botBot
remote_files:shareShare remote files on a user’s behalfUserLegacy botBot
remote_files:writeAdd, edit, and delete remote files on a user’s behalfLegacy botBot
search:readSearch a workspace’s contentUser
search:read.imSearch a workspace's content in direct messagesLegacy botBot
search:read.mpimSearch a workspace's content in group direct messagesLegacy botBot
search:read.privateSearch a workspace's content in private channelsLegacy botBot
search:read.publicSearch a workspace's content in public channelsLegacy botBot
stars:readView messages and files that your slack app has starredUser
stars:writeAdd or remove starsUser
team.billing:readAllows your slack app to read the billing plan for workspaces your slack app has been installed toUserLegacy botBot
team.preferences:readAllows your slack app to read the preferences for workspaces your slack app has been installed toUserLegacy botBot
team:readView the name, email domain, and icon for workspaces your slack app is connected toUserLegacy botBot
tokens.basicExecute methods without needing a scopeUserLegacy botBot
triggers:readRead new Platform triggersUserBot
triggers:writeCreate new Platform triggersUserBot
usergroups:readView user groups in a workspaceUserLegacy botBot
usergroups:writeCreate and manage user groupsUserLegacy botBot
users.profile:readView profile details about people in a workspaceUserLegacy botBot
users.profile:writeEdit a user’s profile information and statusUser
users:readView people in a workspaceUserLegacy botBot
users:read.emailView email addresses of people in a workspaceUserLegacy botBot
users:writeSet presence for your slack appUserLegacy botBot
workflow.steps:executeAdd steps that people can use in Workflow BuilderLegacy botBot

Usage guides

Effortless auth with Bolt

Our Bolt framework can handle authentication for you, letting you get on with building.

Installation & permissions

An overview of the authentication and authorization options available to Slack apps.

Installing with OAuth

OAuth allows app to dynamically request access tokens, imbued with optional permission scopes.

Token types

Read up on the different types of access tokens available to Slack apps.