Slack apps scopes reference

When you create a Slack app and Isolated Cloud site integration, you’ll need to initiate the creation of a site Custom Integration. This process involves the creation of a Custom Integration manifest, which includes Slack scopes and permissions for users and bots.

If your organization’s security posture requires reduced access for Slack, you may need to remove or modify the scopes in the Custom Integration’s manifest. Doing this, however, may impact some app features.

This page maps which Jira and Confluence features are affected by each Slack scope.

Jira features affected by Slack scopes

Slack scopes	Scope Type	Details	Features that are powered by these scopes
app_mentions:read	BOT	View messages that directly mention @Jira in conversations that the app is in	🔔 Bot Mention Handling Respond when @mentioned in channels and opens a project subscription configuration modal App Home interactions - Contextual help and commands
channels:history	BOT	View messages and other content in public channels that Jira Cloud has been added to	🧠 Thread Context Analysis Smart assignee suggestions based on thread participants Context-aware issue creation from discussions For syncing slack threads (New feature)
groups:history	BOT	View messages and other content in private channels that Jira Cloud has been added to
im:history	BOT	View messages and other content in direct messages that Jira Cloud has been added to
channels:read	BOT USER	View basic information about public channels in a workspace Sometimes we need to call conversations.list to get information about channels messages were posted to	🔌 Channel-Issue Connections Connect Slack channels to Jira projects Channel access validation before connections Channel information display in connection setup 📋 Channel Management Channel listing for connection options Member management for invitations Channel metadata retrieval For checking channel type and prompting users
groups:read	BOT USER	View basic information about a user’s private channels View basic information about private channels that Jira Cloud has been added to
im:read	BOT USER	View basic information about direct messages that Jira Cloud has been added to Sometimes we need to call im.list in order to see if our bot is in the list.	For checking channel type and prompting users to Request Access to or Join a Product based on their email address and the products access settings
im:write	BOT	Start direct messages with people	Error management For sending DM to user for announcements, error handling and edge case management
chat:write	BOT	Send messages as @Jira	🔔 Issue Notifications & Alerts Real-time Jira issue updates to Slack channels Issue status changes, comments, assignments Connected channel notifications 🔗 Issue Creation Workflows Confirmation messages after creating issues Error handling and user feedback 🏠 App Home Messaging Welcome messages and onboarding Feature announcements 📝 Message Cleanup Removing outdated login prompts Cleaning up temporary messages
chat:write.public	BOT	Send messages to public channels @Jira isn't a member of
commands	BOT	Add shortcuts and/or slash commands that people can use	⚡ Slash Commands (/jira), few examples: `/jira create` - Issue creation `/jira connect` - Channel connections `/jira issue [key]` - Issue lookup
groups:write	BOT USER	Manage private channels that Jira Cloud has been added to and create new ones Manage a user’s private channels and create new ones on a user’s behalf	👋 Smart Channel Invitations Automatic bot invitations to relevant channels, when subscription created from connect app User creates issue channel connection from the connect app Show channels that user actually has access to on the connect app
channels:write	USER	Manage a user’s public channels and create new ones on a user’s behalf
mpim:write	BOT	Start group direct messages with people	👥 Group DM Support - Issue notifications in group conversations
mpim:read	BOT USER	View basic information about group direct messages that Jira Cloud has been added to View basic information about a user’s group direct messages	👥 Group DM Support - Issue notifications in group conversations
mpim:history	BOT	View messages and other content in group direct messages that Jira Cloud has been added to	🔗 Jira Link Unfurling - When only issue key is shared in the MPIM
links:read	BOT USER	View atlassian.net, jira.com, and team.atlassian.com URLs in messages	🔗 Jira Link Unfurling (Major Feature) Rich Jira link previews when URLs are shared
links:write	BOT USER	Show previews of atlassian.net, jira.com, and team.atlassian.com URLs in messages
team:read	BOT	View the name, email domain, and icon for workspaces Jira Cloud is connected to	🏢 Workspace Management in Connect App Team information display Workspace configuration Multi-workspace support Team validation and diagnostics
users:read	BOT	We use this scope to have ability to view people in a workspace to see their display names	🎯 Smart Assignee Suggestions Assignee recommendations based on thread participants Context-aware user suggestions for issue assignment Thread participant analysis for better issue routing 👥 User Management User profile lookups for notifications Identity resolution and matching User activity tracking
users:read.email	BOT	We use this scope to have ability to view email addresses of people in a workspace	Any action which can be performed without logging in, e.g. rich link previews.

Confluence features affected by Slack scopes

Slack Scopes	Scope Type	Details	Features that are powered by these scopes
app_mentions:read	BOT	View messages that directly mention @Confluence in conversations that the app is in Request Reason: We use this scope to have the ability to view messages that directly mention @Confluence in conversations that the app is in	Bot Mentions: Responding to @Confluence mentions in channels Slash Commands: Triggered via mentions Help & Support: Contextual help when mentioned
channels:history	BOT	View messages and other content in public channels that Confluence Cloud has been added to Request Reason: We use this scope to have the ability to view messages and other content in public channels that Confluence Cloud has been added to.	Subscription Notifications: Posting updates to channels and sending them in batch
channels:manage	BOT	Manage public channels that Confluence Cloud has been added to and create new ones Request Reason: We use this scope to have the ability to invite users to the channel (conversations.invite call).	Auto-invite Bot: Automatically invite Confluence bot to channels when subscriptions are created from Connect app
channels:read	BOT USER	View basic information about public channels in a workspace. Request Reason: We use this scope to read the channel name and type on behalf of user, so we can show it in the list of subscriptions for this user View basic information about public channels in a workspace Request Reason: We use this scope to read the channel name and type on behalf of user, so we can show it in the list of subscriptions for this user	Channel Information: Getting channel names, types, and metadata for subscription management Subscription Display: Showing channel names in subscription lists Channel Validation: Verifying channel access before creating subscriptions
channels:write	USER	Manage a user’s public channels and create new ones on a user’s behalf Request Reason: We use this scope to have the ability to auto-invite the Confluence bot to the channel when they create a subscription to a public channel.	Auto-invite Bot: Automatically inviting bot to public channels on behalf of user Seamless Setup: Enabling bot access when user creates subscriptions
chat:write	BOT	Send messages as @Confluence Request Reason: We use this scope to have the ability to send messages as Confluence bot to the channels where the bot is present.	Subscription Notifications: Sending Confluence page/space updates to channels Bot Responses: Replying to slash commands and interactions Welcome Messages: Onboarding and setup messages
chat:write.public	BOT	Send messages to channels @Confluence isn't a member of Request Reason: We use this scope to have the ability to send messages as Confluence bot to the public channels.	Link Previews: Posting unfurls to public channels User Access (Joining/Requesting access) Notifications / prompts: Sending updates to public channels without bot membership Share Feature: Sharing Confluence content to public channels
commands	BOT	Add shortcuts and/or slash commands that people can use Request Reason: We use this scope to have the ability to introduce slash commands that people can use to interact with the bot, for example manage subscriptions.	Slash Commands: `/confluence` commands e.g. List Subscriptions: `/confluence list` Connect Account: `/confluence connect` Help: `/confluence help` Saved Content: `/confluence saved` Tasks: `/confluence tasks`
groups:history	BOT	View messages and other content in private channels that Confluence Cloud has been added to Request Reason: We use this scope to have the ability to view messages and other content in private channels that Confluence Cloud has been added to.	Link Unfurling: Detecting Confluence links in private channels
groups:read	BOT USER	View basic information about private channels that Confluence Cloud has been added to Request Reason: We use this scope to have the ability to view basic information about private channels that Confluence Cloud has been added to. View basic information about a user’s private channels Request Reason: We use this scope to read the channel name and type on behalf of user, so we can show it in the list of subscriptions for this user	Private Channel Info: Getting private channel names and metadata Subscription Management: Managing subscriptions for private channels Access Validation: Verifying private channel access
groups:write	BOT USER	Manage private channels that Confluence Cloud has been added to and create new ones Request Reason: We use this scope to have the ability to invite users to the private channel (conversations.invite call). Manage a user’s private channels and create new ones on a user’s behalf Request Reason: We use this scope to have the ability to auto-invite the Confluence bot to the channel when they create a subscription to a private channel.	Auto-invite to Private Channels: Inviting bot to private channels for subscriptions Private Channel Management: Managing bot membership and not send unfurl again for a ntoification
im:history	BOT	View messages and other content in direct messages that Confluence Cloud has been added to Request Reason: We use this scope to have the ability to view messages and other content in direct messages that Confluence Cloud has been added to.	Link Unfurling: Detecting Confluence links in private channels
im:read	BOT	View basic information about direct messages that Confluence Cloud has been added to Request Reason: We use this scope to have the ability to view basic information about direct messages that Confluence Cloud has been added to	Private Channel Info: Getting private channel names and metadata Subscription Management: Managing subscriptions for private channels Access Validation: Verifying private channel access for a user in connect app
im:write	BOT	Start direct messages with people Request Reason: We use this scope to have the ability to start direct messages with people (conversations.open call).	Open dm as a bot user
links:read	BOT USER	View atlassian.net, http://jira.com , and team.atlassian.com URLs in messages Request Reason: We use this scope to have ability to listen to Confluence links when they are shared in the channel	Major Features Link Previews: Showing rich previews of Confluence pages, blogs, spaces Content Unfurling: Displaying page titles, excerpts, and interactive elements
links:write	BOT USER	Show previews of atlassian.net, http://jira.com , and team.atlassian.com URLs in messages Request Reason: We use this scope to post link previews when the user shares Confluence link
mpim:history	BOT	View messages and other content in group direct messages that Confluence Cloud has been added to Request Reason: We use this scope to have ability to view messages and other content in group direct messages that Confluence Cloud has been added to	Group DM Support: Processing links and interactions in group DMs Multi-party Notifications: Sending updates to group conversations
mpim:read	BOT	View basic information about group direct messages that Confluence Cloud has been added to Request Reason: We use this scope to have ability to view basic information about group direct messages that Confluence Cloud has been added to	Group DM Info: Getting group DM metadata Multi-user Notification Management: Managing notifications for group conversations
mpim:write	BOT	Start group direct messages with people Request Reason: We use this scope to have ability to start group direct messages with people	Group Notifications: Sending notifications / messages to group DMs Multi-user Collaboration: Facilitating group discussions around Confluence content
reactions:read	BOT	View emoji reactions and their associated content in channels and conversations that Confluence Cloud has been added to Request Reason: We use this scope to get the events when a user liked an unfurl with a Confluence page (or starred that) to replay the likes on Confluence side or add this page to favorites in Confluence	Like Sync: Syncing Slack reactions to Confluence likes
team:read	BOT	View the name, email domain, and icon for workspaces Confluence Cloud is connected to Request Reason: We use this scope to have ability to view the name, email domain, and icon for workspaces Confluence Cloud is connected to	Workspace Information: Getting workspace name, domain, and branding. Team Management: Displaying workspace details in admin interfaces Analytics: Tracking usage across different workspaces
users.profile:read	BOT	View profile details about people in a workspace Request Reason: We use this scope to have ability to view profile details about people in a workspace	User Information: Getting user details for notifications and mentions Account Matching: Linking Slack users to Confluence accounts Mention Resolution: Resolving user mentions in content Team Directory: Building user directories for admin features
users:read	BOT	View people in a workspace Request Reason: We use this scope to have ability to view people in a workspace
users:read.email	BOT	View email addresses of people in a workspace Request Reason: We use this scope to have ability to view email addresses of people in a workspace	Account Linking: Matching Slack users to Confluence accounts by email Authentication: Verifying user identity during account connection User Management: Admin features for managing user connections

Was this helpful?

It wasn't accurateIt wasn't clearIt wasn't relevant

Still need help?

The Atlassian Community is here for you.

Ask the Community