> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> How to set up the Slack connector, plus the actions that are available.

![Slack](https://stackone-logos.com/api/slack/filled/svg)

v6.0.0[See changelog](https://docs.stackone.com/connectors/slack/changelog.md)

[95 actions](#actions) · 4 auth methods

Messaging
IAM

## Getting Started

**1. Create or Select a Project**

Set up a new project or select an existing one. See [Organizations & Projects](https://docs.stackone.com/gateway/concepts/organizations-and-projects.md).

**2. Configure the Connector**

Enable the connector and create a Connector Profile in your project. See [Setup Connector Profile](https://docs.stackone.com/gateway/quickstart.md#setup-connector-profile).

> [card] [OAuth 2.0 (Bot) · Connector Profile](https://docs.stackone.com/connectors/slack/guides/connector-profile/oauth-2-0-bot.md)
>
> Authenticate your app to perform automated actions as a bot. Best for integrations, automation, and managing workspace o...

> [card] [OAuth 2.0 (User) · Connector Profile](https://docs.stackone.com/connectors/slack/guides/connector-profile/oauth-2-0-user.md)
>
> Authenticate with your personal Slack account to perform actions as yourself. Provides access to your profile, private c...

> [card] [Bot Access Token · Connector Profile](https://docs.stackone.com/connectors/slack/guides/connector-profile/bot-access-token.md)
>
> No refresh flow. Uses a static Bot User OAuth Token (xoxb-) copied from your Slack app; actions run as the app's bot use...

> [card] [User Access Token · Connector Profile](https://docs.stackone.com/connectors/slack/guides/connector-profile/user-access-token.md)
>
> No refresh flow. Uses a static User OAuth Token (xoxp-) copied from your Slack app; actions run as the user who installe...

**3. Link an Account**

Link an account [from the dashboard](https://docs.stackone.com/connect/managing-connectors/linking-accounts.md#link-from-the-dashboard) (or via [StackOne Hub](https://docs.stackone.com/embed/account-linking/overview)).

See the guide for the authentication type chosen in the Connector Profile:

> [card] [OAuth 2.0 (Bot) · Link Account](https://docs.stackone.com/connectors/slack/guides/link-account/oauth-2-0-bot.md)

> [card] [OAuth 2.0 (User) · Link Account](https://docs.stackone.com/connectors/slack/guides/link-account/oauth-2-0-user.md)

> [card] [Bot Access Token · Link Account](https://docs.stackone.com/connectors/slack/guides/link-account/bot-access-token.md)

> [card] [User Access Token · Link Account](https://docs.stackone.com/connectors/slack/guides/link-account/user-access-token.md)

**4. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Actions

Authentication type

Select all
|
Clear

Bot Access Token

OAuth 2.0 (Bot)

OAuth 2.0 (User)

User Access Token

No auth methods found

Scopes

Select all
|
Clear

bookmarks:read

bookmarks:write

canvases:read

canvases:write

channels:history

channels:join

channels:manage

channels:read

channels:write

channels:write.invites

chat:write

conversations.connect:manage

conversations.connect:write

files:read

files:write

groups:history

groups:read

groups:write

groups:write.invites

im:history

im:read

im:write

lists:read

lists:write

mpim:history

mpim:read

mpim:write

pins:read

pins:write

reactions:read

reactions:write

search:read

team:read

usergroups:read

usergroups:write

users.profile:read

users.profile:write

users:read

users:read.email

users:write

No scopes found

95 actions

ActionDescriptionRequired scopes

Add Bookmark`slack_add_bookmark`

Add a bookmark to a channel

`bookmarks:write`

Edit Bookmark`slack_edit_bookmark`

Edit an existing bookmark in a channel

`bookmarks:write`

List Bookmarks`slack_list_bookmarks`

List the bookmarks in a channel

`bookmarks:read`

Remove Bookmark`slack_remove_bookmark`

Remove a bookmark from a channel

`bookmarks:write`

Create Channel Canvas`slack_create_channel_canvas`

Create the canvas tab of a channel

`canvases:write`

Create Canvas`slack_create_canvas`

Create a standalone canvas

`canvases:write`

Edit Canvas`slack_edit_canvas`

Edit an existing canvas

`canvases:write`

Delete Canvas`slack_delete_canvas`

Delete a canvas

`canvases:write`

Get Canvas Content`slack_get_canvas_content`

Get the full content of a canvas as markdown or HTML

`canvases:read`

Lookup Canvas Sections`slack_lookup_canvas_sections`

Find canvas sections matching criteria

`canvases:read`

Set Canvas Access`slack_set_canvas_access`

Set the access level to a canvas for channels or users

`canvases:write`

Delete Canvas Access`slack_delete_canvas_access`

Remove access to a canvas for a channel or a user

`canvases:write`

List Conversations`slack_list_conversations`

List conversations (channels, groups, DMs) in the Slack workspace, each with its ID, name, and properties

`channels:read``groups:read``mpim:read``im:read`

Get Conversation`slack_get_conversation`

Get details of a specific conversation

`channels:read``groups:read``mpim:read``im:read`

Create Conversation`slack_create_conversation`

Create a new conversation (channel)

`channels:write``groups:write`

Join Conversation`slack_join_conversation`

Join an existing conversation (use before sending messages to new channels)

`channels:join`

Leave Conversation`slack_leave_conversation`

Leave a conversation

`channels:write``groups:write`

Rename Conversation`slack_rename_conversation`

Rename a conversation

`channels:write``groups:write`

Set Conversation Purpose`slack_set_conversation_purpose`

Set the description (purpose) of a conversation

`channels:manage``groups:write``im:write``mpim:write``channels:write`

Set Conversation Topic`slack_set_conversation_topic`

Set the topic of a conversation

`channels:manage``groups:write``im:write``mpim:write``channels:write`

Archive Conversation`slack_archive_conversation`

Archive a conversation

`channels:manage``groups:write``im:write``mpim:write``channels:write`

Unarchive Conversation`slack_unarchive_conversation`

Unarchive a previously archived conversation

`channels:manage``groups:write``im:write``mpim:write``channels:write`

Close Conversation`slack_close_conversation`

Close a direct message or multi-person direct message

`channels:manage``groups:write``im:write``mpim:write``channels:write`

Mark Conversation Read`slack_mark_conversation_read`

Set the read cursor of a conversation to a message

`channels:manage``groups:write``im:write``mpim:write``channels:write`

Invite Users To Conversation`slack_invite_users_to_conversation`

Invite users to a conversation

`channels:write.invites``groups:write.invites`

Invite Shared Conversation`slack_invite_shared_conversation`

Send an invitation to a Slack Connect channel

`conversations.connect:write`

Remove User From Conversation`slack_kick_user_from_conversation`

Remove a user from a conversation

`channels:write``groups:write`

List Conversation Members`slack_list_conversation_members`

List all members of a conversation

`channels:read``groups:read``mpim:read``im:read`

Open Conversation`slack_open_conversation`

Open or resume a direct message or multi-person direct message

`im:write``mpim:write`

List Thread Replies`slack_list_thread_replies`

Retrieve a thread of messages posted to a conversation

`channels:history``groups:history``mpim:history``im:history`

List Slack Connect Invites`slack_list_connect_invites`

List shared channel invites that have been generated or received

`conversations.connect:manage`

List Files`slack_list_files`

List files for a team, channel, or user

`files:read`

Get File`slack_get_file`

Get detailed information about a file

`files:read`

Delete File`slack_delete_file`

Delete a file from Slack

`files:write`

Get File Upload URL`slack_get_upload_url`

Get an external URL to upload a file to Slack

`files:write`

Complete File Upload`slack_complete_file_upload`

Complete an external file upload and optionally share to channels

`files:write`

Share File Public URL`slack_share_file_public_url`

Create a public URL for a file

`files:write`

Revoke File Public URL`slack_revoke_file_public_url`

Revoke public sharing for a file

`files:write`

Get Unified Credentials`slack_unified_get_me`

Get the current Slack connection's unified credentials and identity.

Auth Test`slack_auth_test`

Validate the current Slack token via auth.test and return the raw response.

List Unified Groups`slack_unified_list_groups`

List unified groups (Slack user groups) in a workspace.

`usergroups:read`

Get Unified Group`slack_unified_get_group`

Get a unified Slack group by ID.

`usergroups:read`

List Unified Organizations`slack_unified_list_organizations`

List unified organizations in Slack.

`team:read`

Get Unified Organization`slack_unified_get_organization`

Get a unified Slack organization by ID.

`team:read`

List Unified Resource Types`slack_unified_list_resource_types`

List unified resource types in Slack.

List Unified Resource Users`slack_unified_list_resource_users`

List unified resource users for a Slack channel.

List Unified Roles`slack_unified_list_roles`

List unified roles in a Slack workspace.

Get Unified Role`slack_unified_get_role`

Get a unified Slack role by ID.

List Unified Users`slack_unified_list_users`

List unified users in the Slack workspace.

`users:read`

Get Unified User`slack_unified_get_user`

Get a unified Slack user by ID.

`users:read`

Create List`slack_create_list`

Create a new Slack List

`lists:write`

Update List`slack_update_list`

Update a Slack List's name, description or todo mode

`lists:write`

Create List Item`slack_create_list_item`

Add a new item (row) to a Slack List

`lists:write`

Get List Item`slack_get_list_item`

Get a single item (row) from a Slack List

`lists:read`

List List Items`slack_list_list_items`

List the items (rows) of a Slack List

`lists:read`

Update List Item`slack_update_list_item`

Update cells of items in a Slack List

`lists:write`

Delete List Item`slack_delete_list_item`

Delete an item (row) from a Slack List

`lists:write`

Delete List Items`slack_delete_list_items`

Delete multiple items (rows) from a Slack List

`lists:write`

Set List Access`slack_set_list_access`

Set the access level of users or channels to a Slack List

`lists:write`

Delete List Access`slack_delete_list_access`

Revoke users' or channels' access to a Slack List

`lists:write`

Start List Download`slack_start_list_download`

Start an export job for a Slack List

`lists:read`

Get List Download`slack_get_list_download`

Get the download URL of a Slack List export job

`lists:read`

List Messages`slack_list_messages`

List messages from a conversation

`channels:history``groups:history``mpim:history``im:history`

Send Message`slack_send_message`

Send a message to a channel or conversation

`chat:write`

Update Message`slack_update_message`

Update an existing message

`chat:write`

Delete Message`slack_delete_message`

Delete a message

`chat:write`

Send Ephemeral Message`slack_send_ephemeral_message`

Send a private temporary message visible only to a specific user in a channel (use for private welcome notes, warnings,...

`chat:write`

Schedule Message`slack_schedule_message`

Schedule a message to be sent at a specific time

`chat:write`

List Scheduled Messages`slack_list_scheduled_messages`

List all scheduled messages

`chat:write`

Delete Scheduled Message`slack_delete_scheduled_message`

Delete a scheduled message

`chat:write`

Get Message Permalink`slack_get_message_permalink`

Get a permanent link to a message

`channels:history``groups:history``mpim:history``im:history`

Search Messages`slack_search_messages`

Search for messages matching a query

`search:read`

Add Pin`slack_add_pin`

Pin a message to a channel

`pins:write`

List Pins`slack_list_pins`

List items pinned to a channel

`pins:read`

Remove Pin`slack_remove_pin`

Unpin a message from a channel

`pins:write`

Add Reaction`slack_add_reaction`

Add an emoji reaction to a message

`reactions:write`

Get Reactions`slack_get_reactions`

Get all reactions on a message or file

`reactions:read`

List Reactions`slack_list_reactions`

List items a user has reacted to

`reactions:read`

Remove Reaction`slack_remove_reaction`

Remove an emoji reaction from a message or file

`reactions:write`

List User Groups`slack_list_usergroups`

List the user groups in the workspace

`usergroups:read`

List User Group Users`slack_list_usergroup_users`

List the member user IDs of a user group

`usergroups:read`

Create User Group`slack_create_usergroup`

Create a user group

`usergroups:write`

Update User Group`slack_update_usergroup`

Update the properties of an existing user group

`usergroups:write`

Enable User Group`slack_enable_usergroup`

Re-enable a previously disabled user group

`usergroups:write`

Disable User Group`slack_disable_usergroup`

Disable an existing user group

`usergroups:write`

Update User Group Members`slack_update_usergroup_users`

Replace the full member list of a user group

`usergroups:write`

List Users`slack_list_users`

List all users in the Slack workspace, each with ID, name, display name, email, and profile

`users:read`

List User Conversations`slack_list_user_conversations`

List conversations a user is a member of

`users:read``channels:read``groups:read``mpim:read``im:read`

Get User`slack_get_user`

Get details of a specific user

`users:read`

Get User By Email`slack_get_user_by_email`

Get user details by email address (use to find user ID from email)

`users:read.email`

Lookup Discoverable Contact`slack_lookup_discoverable_contact`

Check if an email is discoverable on Slack

`users:read``users:read.email`

Get User Profile`slack_get_user_profile`

Retrieve a user's profile information including status text and emoji, title, phone, and custom profile fields

`users.profile:read`

Set User Profile`slack_set_user_profile`

Update a user's profile information

`users.profile:write`

Get User Presence`slack_get_user_presence`

Get the presence of a user

`users:read`

Set User Presence`slack_set_user_presence`

Manually set the user's presence

`users:write`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.