Skip to main content

Slack

Comprehensive Slack connector for managing messages, channels, users, and file operations.

📝 Note: This connector gives agents access to Slack data. To chat with your agents inside Slack, see Slack integration.

What you can ask​

  • Summarize everything discussed in #incidents-prod over the last 24 hours.
  • Find every message in #engineering mentioning broken from this week and create a Linear ticket for each.
  • Send a weekly update to #leadership with the deliverables shipped this week.

Set up​

Slack needs an OAuth application from your organization before anyone can connect. An organization admin completes these steps once.

  1. Go to Organization > Connectors and find Slack. Click Enable, and choose which tools to allow.
  2. Create an OAuth application in the Slack app dashboard.
  3. Add the Redirect URI shown in the connector settings to the application.
  4. Copy the application's Client ID and Client Secret into the connector, then save it.
  5. Each member connects their own account the first time they use it.

⚠️ Warning: Do not enter your Devs.ai or Slack login email or password in the OAuth application fields.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

OAuth scopes used by these tools (40)

Grant the scopes for the tools you plan to allow.

  • bookmarks:read
  • bookmarks:write
  • canvases:write
  • channels:history
  • channels:read
  • channels:write
  • channels:write.invites
  • channels:write.topic
  • chat:write
  • dnd:write
  • files:read
  • files:write
  • groups:history
  • groups:read
  • groups:write
  • im:history
  • im:read
  • im:write
  • mpim:history
  • mpim:read
  • mpim:write
  • pins:read
  • pins:write
  • reactions:read
  • reactions:write
  • search:read
  • search:read.files
  • search:read.im
  • search:read.mpim
  • search:read.private
  • search:read.public
  • search:read.users
  • team:read
  • usergroups:read
  • usergroups:write
  • users.profile:read
  • users.profile:write
  • users:read
  • users:read.email
  • users:write

Tools​

Slack offers 79 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (32)​

View and search information without changing it.

ToolWhat it does
get_channel_infoGet information about a channel using Channel ID (not channel name)
get_channel_membersGet members of a channel
get_conversation_historyGet message history from a channel by Channel ID.
get_conversation_repliesGet all replies in a Slack thread.
get_current_userResolve the authenticated user ('me'/'myself') to their Slack user ID and profile.
get_file_contentGet the content of a file.
get_file_infoGet a file's metadata: name, type, size, owner and share locations.
get_message_permalinkGet a permanent link to a message
get_reactionsRead the emoji reactions on a message: which emoji, how many people used each, and the user IDs who did.
get_team_infoGet the authenticated user's Slack workspace: its ID, name, slug and email domain.
get_unread_messages_from_channelGet all unread messages from a specific channel.
get_unread_messages_from_userGet all unread direct messages from a specific user.
get_user_infoGet complete user information including workspace role, permissions, and profile
get_user_presenceCheck whether a user is active or away.
get_user_profileGet a user's full Slack profile including title, phone, timezone, status and any workspace custom fields.
get_users_conversationsGet conversations a user is a member of.
list_bookmarksList the bookmarks pinned to a channel's header.
list_channelsList channels in the workspace (public and private; direct messages are excluded by default).
list_filesList files in the workspace, most recent first by default. sort (created|timestamp) and sort_dir (asc|desc) order the returned page only - files.list has no server-side sort, so ordering is not consistent across pages.
list_pinned_messagesList all pinned messages and items in a channel
list_scheduled_messagesList scheduled messages that haven't been sent yet
list_unread_channel_messagesGet all unread messages from channels with their message content.
list_unread_direct_messagesGet all unread direct messages and group DMs with their message content.
list_usergroup_usersList the member user IDs of one user group.
list_usergroupsList the workspace's user groups (mentionable @handles, also called subteams).
list_usersList users in the workspace.
lookup_user_by_emailResolve an email address to a Slack user, returning their ID and profile.
read_file_textRead a Slack file as text; prefer over get_file_content to READ a PDF, DOCX, XLSX or text file. file_id: list_files or search_files.
search_contextSearch Slack semantically, built for agents.
search_filesSearch for files across Slack using keywords with enhanced timestamp handling and automatic pagination.
search_messagesSearch Slack messages using Slack's exact search syntax.
validate_credentialValidate Slack credentials.

Write (17)​

Create or send data.

ToolWhat it does
add_bookmarkPin a link to a channel's header as a bookmark.
add_reactionAdd an emoji reaction to a message
create_canvasCreate a new standalone Slack canvas with optional title and markdown content.
create_channelCreate a new channel
create_channel_canvasCreate a canvas linked to a Slack channel.
create_usergroupCreate a user group (a mentionable @handle).
invite_to_channelInvite one or more users to a channel by ID.
invite_usergroup_to_channelInvite every current member of a user group to a channel.
join_channelJoin a channel
open_dmOpen a direct message conversation with one user, or a group DM with several, and return the conversation ID to pass to post_message.
pin_messagePin a message to a channel
post_ephemeral_messagePost a message only one user can see in a channel, leaving no trace for anyone else.
post_messageSend a message to a Slack channel using Channel ID (not channel name).
post_message_by_nameSend a message to a person or channel by name instead of ID.
schedule_messageSchedule a message to be sent later
share_fileShare an existing file into one or more channels by posting its permalink, which Slack unfurls into a file attachment.
upload_fileUpload a file or image to Slack.

Delete or overwrite (30)​

Remove or replace existing data.

ToolWhat it does
archive_channelArchive a channel, making it read-only for everyone.
clear_user_statusClear the status for a user
close_conversationClose a direct message or group direct message, removing it from your own sidebar.
delete_canvasPermanently delete a Slack canvas by ID.
delete_filePermanently delete a file and remove it from every conversation it was shared in.
delete_messageDelete a message from Slack
delete_scheduled_messageDelete a scheduled message
disable_usergroupDisable a user group so it can no longer be mentioned.
edit_bookmarkChange an existing channel bookmark's title, link or emoji.
edit_canvasWrite to or edit an existing Slack canvas by applying one or more change operations.
enable_usergroupRe-enable a disabled user group so it can be mentioned again.
kick_from_channelRemove a user from a channel
leave_channelLeave a public or private channel you are a member of.
make_file_publicCreate a public share URL for a file, readable without a Slack account.
mark_channel_readMark a channel as read up to a given message, clearing its unread badge for the authenticated user.
remove_bookmarkRemove a bookmark from a channel's header.
remove_reactionRemove an emoji reaction from a message
rename_channelRename a channel
revoke_file_public_urlRevoke a file's public share URL, so it is again readable only inside Slack.
set_channel_purposeSet the purpose for a channel
set_channel_topicSet the topic for a channel
set_dnd_durationTurn on Do Not Disturb for your own account for a number of minutes from now.
set_user_presenceSet your own presence status (auto or away)
set_user_profileSet profile information for a user
set_user_statusSet your status text and emoji. status_text is required: pass an empty string to clear it.
set_usergroup_usersReplace a user group's entire membership with the given user IDs.
unarchive_channelRestore a previously archived channel to active use.
unpin_messageRemove a pinned message from a channel
update_messageUpdate an existing message in Slack.
update_usergroupUpdate a user group's name, handle, description, or default channels.
⌘J