> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/slack.md).

# Slack

Interact with Slack workspaces and channels.

* Federated Search

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector         | Authentication |
| ----------------- | -------------- |
| Slack             | OAuth sign-in  |
| Slack (Bot Token) | Credentials    |

### Slack

Connect to Slack using OAuth2 for automatic authentication. This method handles token management automatically and provides access to all Slack features based on your app's configured scopes. Recommended for end users.

#### Set up in Slack

1. Use a Slack account with access to the records and operations that your workflow needs.
2. If your organization restricts application access or user consent, have its administrator approve the connection before you sign in.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Slack**.
2. Select **Connect**, sign in to the provider account, and review the requested access. Complete authorization to return to StackAI.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

StackAI obtains the OAuth credentials during sign-in. You do not need to paste an access token or refresh token.

**Provider documentation:** [Setup reference](https://api.slack.com/authentication/oauth-v2).

### Slack (Bot Token)

Connect to Slack using a Bot Token to send messages, interact with channels, and retrieve conversation history. You'll need a Slack app with a Bot User OAuth Token (xoxb-) and the target Channel ID. Ensure your bot has the required scopes and is installed in your workspace.

#### Set up in Slack

1. Go to the Slack API apps page and create a Slack app for your workspace.
2. Under OAuth & Permissions, add the Bot Token Scopes your workflow needs, then install the app to your workspace.
3. Copy the Bot User OAuth Token (starts with xoxb-) and note the target Channel ID.

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Slack (Bot Token)**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field | Required | What to enter                                                                                                                                                                                                                                                                                                                                                             |
| ------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Bot Token     | Yes      | How to get your Bot Token: 1) Go to api.slack.com/apps → Your App → OAuth & Permissions 2) Copy the 'Bot User OAuth Token' (starts with xoxb-) 3) Ensure your bot has required scopes: channels:read, channels:history, files:read, users:read 4) Install/reinstall your app to workspace. [Provider instructions](https://api.slack.com/authentication/token-types#bot). |

**Provider documentation:** [Setup reference](https://api.slack.com/authentication/token-types).

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

### Detailed setup guides

* [Connect Slack with OAuth](https://docs.stackai.com/integrations/catalog/slack/connect-slack-with-oauth.md)
* [Configure a Slack bot](https://docs.stackai.com/integrations/catalog/slack/configure-a-slack-bot.md)
* [Configure a custom Slack app](https://docs.stackai.com/integrations/catalog/slack/configure-a-custom-slack-app.md)

## Use an action

1. Add the required **Slack** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### Create Channel

Create a new public or private Slack channel

#### Inputs

| Field           | Type    | Required | Description                                                           |
| --------------- | ------- | -------- | --------------------------------------------------------------------- |
| Channel Name    | string  | Yes      | The name of the channel to create (without # prefix).                 |
| Private Channel | boolean | No       | Whether to create a private channel (default: false). Default: false. |

#### Outputs

| Field           | Type   | Description                                      |
| --------------- | ------ | ------------------------------------------------ |
| Created Channel | object | Details of the successfully created channel.     |
| Success Message | string | Confirmation message about the channel creation. |

### Get Channel Info

Get detailed information about a specific Slack channel including metadata and settings

#### Inputs

| Field              | Type            | Required | Description                                                                            |
| ------------------ | --------------- | -------- | -------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel to get information about. Options load from the selected connection. |

#### Outputs

| Field               | Type   | Description                                      |
| ------------------- | ------ | ------------------------------------------------ |
| Channel Information | object | Detailed information about the channel.          |
| Channel Type        | string | The type of channel (public, private, dm, mpim). |
| Channel Summary     | string | Human-readable summary of the channel.           |

### List Channels

List public and private channels available to the connected Slack app.

#### Inputs

| Field             | Type                      | Required | Description                                                                                                         |
| ----------------- | ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------- |
| Channel Types     | multiple\_select (string) | No       | Types of channels to include. Available values: Public Channels, Private Channels. Default: \["public", "private"]. |
| Exclude Archived  | boolean                   | No       | Exclude archived channels from the results. Default: true.                                                          |
| Max Channels      | integer                   | No       | Maximum number of channels to return (ignored when Return All is enabled). Default: 200.                            |
| Return All        | boolean                   | No       | Fetch all channels across all pages automatically. Default: false.                                                  |
| Pagination Cursor | string                    | No       | Cursor for fetching the next page of results. Default: .                                                            |

#### Outputs

| Field       | Type          | Description                                               |
| ----------- | ------------- | --------------------------------------------------------- |
| Channels    | object\_array | List of public/private channels visible to the Slack app. |
| Total Count | number        | Number of channels returned.                              |
| Has More    | boolean       | Whether there are more channels available.                |
| Next Cursor | string        | Cursor for fetching the next page of results.             |

### Send Message

Send a message to Slack. Choose Plain Text for simple messages with Markdown, or Block Kit for rich formatting with images, dividers, and custom layouts. Plain Text mode can also attach file URLs or Slack file IDs.

#### Inputs

| Field                       | Type            | Required | Description                                                                                                                                                                                                                                                                                    |
| --------------------------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Channel Name or ID          | select (string) | Yes      | The Slack channel to send the message to. Options load from the selected connection.                                                                                                                                                                                                           |
| Thread ID to Reply in       | string          | No       | Reply in a thread. Pass the thread\_id from a trigger (e.g., On App Mention) to continue the conversation in that thread.                                                                                                                                                                      |
| Message Format              | select (string) | Yes      | Choose Plain Text for simple messages or Block Kit for rich formatting with images, dividers, and custom layouts. Available values: Plain Text, Block Kit. Default: plain\_text.                                                                                                               |
| Message                     | textarea        | No       | Message text in standard Markdown format. Supports: **bold**, *italic*, ~~strikethrough~~, \`code\`, \`\`\`code blocks\`\`\`, # headings, - bullets, and `[text](url)` links. Auto-converts to Slack format. If you include citation\_list from an LLM node, citations will be auto-formatted. |
| Blocks (JSON)               | textarea        | No       | Slack Block Kit blocks as JSON array. Design your message at <https://app.slack.com/block-kit-builder> then paste the blocks array here.                                                                                                                                                       |
| File Source                 | select (string) | No       | Choose how to attach files in Plain Text mode. For new workflows, use URLs or Slack file IDs. Available values: None, URL(s), Slack File ID(s). Default: none.                                                                                                                                 |
| Attachment URL(s)           | textarea        | No       | Public file URLs to attach. Separate multiple values with commas, new lines, or semicolons.                                                                                                                                                                                                    |
| Attachment Slack File ID(s) | textarea        | No       | Existing Slack file IDs to re-attach. Separate multiple values with commas, new lines, or semicolons.                                                                                                                                                                                          |
| Files (Legacy)              | object\_array   | No       | Optional files to attach. Add one item per file. Each item can be a Slack file\_id, a URL, or an uploaded file.                                                                                                                                                                                |
| Make Files Public           | boolean         | No       | If true, create public links for uploaded files that can be accessed without authentication. Default: false.                                                                                                                                                                                   |

#### Outputs

| Field              | Type          | Description                                                   |
| ------------------ | ------------- | ------------------------------------------------------------- |
| Channel ID         | string        | Slack channel ID where message was posted.                    |
| Status             | string        | Message delivery status with channel and timestamp details.   |
| Message Timestamp  | string        | Unique timestamp identifier for the Slack message.            |
| Uploaded Files     | object\_array | List of files that were uploaded and shared with the message. |
| Files Shared Count | number        | Number of files shared with the message.                      |

### Send and Wait for Response

Send an interactive Slack message that collects user responses. Choose Plain Text for simple messages or Block Kit for rich formatting. Interactive buttons are automatically appended in both modes.

#### Inputs

| Field                           | Type            | Required | Description                                                                                                                                                                                                                                               |
| ------------------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Message Format                  | select (string) | Yes      | Choose Plain Text for simple messages or Block Kit for rich formatting with images, dividers, and custom layouts. Interactive buttons are automatically appended in both modes. Available values: Plain Text, Block Kit. Default: plain\_text.            |
| Message                         | textarea        | No       | The message shown to users above the response buttons. This appears under the 'Approval needed' header in Slack. Supports Markdown: **bold**, *italic*, `[links](url)`. If you include citation\_list from an LLM node, citations will be auto-formatted. |
| Blocks (JSON)                   | textarea        | No       | Slack Block Kit blocks as JSON array. Your content blocks will appear above the auto-appended interactive buttons. Design your message at <https://app.slack.com/block-kit-builder> then paste the blocks array here.                                     |
| Channel Name or ID              | select (string) | Yes      | The Slack channel where the interactive message will be posted. Options load from the selected connection.                                                                                                                                                |
| Thread ID to Reply in           | string          | No       | Reply in a thread. Pass the thread\_id from a trigger (e.g., On App Mention) to continue the conversation in that thread.                                                                                                                                 |
| Response Type                   | select (string) | Yes      | How users will respond: Approval shows Approve/Disapprove buttons, Free Text shows a text input field, Modal Form opens a popup with text and file upload. Available values: Approval, Free Text, Modal Form. Default: approval.                          |
| Approve Button Text             | string          | No       | Custom text for the approve button. Only applies when Response Type is 'Approval'. Defaults to 'Approve'.                                                                                                                                                 |
| Show Disapprove Button          | boolean         | No       | Show a Disapprove button alongside Approve. Only applies when Response Type is 'Approval'. Default: true.                                                                                                                                                 |
| Disapprove Button Text          | string          | No       | Custom text for the disapprove button. Only applies when Response Type is 'Approval' and Disapprove button is shown. Defaults to 'Disapprove'.                                                                                                            |
| Free Text: Response Placeholder | string          | No       | Placeholder text shown in the response text field. Only applies when Response Type is 'Free Text'. Defaults to 'Type your response here...'.                                                                                                              |
| Button Style                    | select (string) | No       | Color theme for buttons. Standard uses green for approve and red for disapprove. Caution reverses the colors. Neutral uses gray for all buttons. Available values: Standard (green / red), Neutral (gray), Caution (red / green). Default: primary.       |

#### Outputs

| Field             | Type   | Description                                                  |
| ----------------- | ------ | ------------------------------------------------------------ |
| Channel ID        | string | The Slack channel ID where the interactive message was sent. |
| Results           | string | The status of the interactive message sent.                  |
| Message Timestamp | string | Slack message timestamp (unique identifier).                 |
| Resume Output     | dict   | User interaction data when workflow resumes.                 |
| Resume Token      | string | Token to resume the workflow after user response.            |

### List Slack Files

List files in the Slack workspace with optional filtering

#### Inputs

| Field              | Type                      | Required | Description                                                                                              |
| ------------------ | ------------------------- | -------- | -------------------------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string)           | No       | Only show files shared in this channel. Options load from the selected connection.                       |
| User               | string                    | No       | Only show files uploaded by this user.                                                                   |
| From Timestamp     | string                    | No       | Only show files created after this time.                                                                 |
| To Timestamp       | string                    | No       | Only show files created before this time.                                                                |
| File Types         | multiple\_select (string) | No       | Only show specific file types. Available values: All, Spaces, Snippets, Images, Google Docs, Zips, PDFs. |
| Number of Files    | integer                   | No       | How many files to return. Defaults to 20. Default: 20.                                                   |
| Show Hidden Files  | boolean                   | No       | Include files hidden due to free workspace storage limits. Default: false.                               |
| Page               | integer                   | No       | Page number of results (default: 1).                                                                     |

#### Outputs

| Field              | Type          | Description                                 |
| ------------------ | ------------- | ------------------------------------------- |
| Files              | object\_array | List of files matching the filter criteria. |
| Total Count        | number        | Total number of files returned.             |
| Has More Files     | boolean       | Whether there are more files available.     |
| Hidden Files Count | number        | Number of files hidden by workspace limits. |
| Current Page       | number        | Current page number.                        |
| Total Pages        | number        | Total number of pages available.            |

### Get Slack File Info

Get detailed information about a specific Slack file

#### Inputs

| Field              | Type            | Required | Description                                                                               |
| ------------------ | --------------- | -------- | ----------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | Select a channel to list files from. Options load from the selected connection.           |
| File ID            | select (string) | Yes      | The Slack file ID to retrieve information for. Options load from the selected connection. |

#### Outputs

| Field               | Type   | Description                                                                    |
| ------------------- | ------ | ------------------------------------------------------------------------------ |
| File Details        | object | Complete metadata about the file including name, size, type, and sharing info. |
| Access URLs         | object | URLs for downloading or viewing the file.                                      |
| Sharing Information | object | Lists of channels, groups, and DMs where this file has been shared.            |

### Delete Slack File

Delete a file from the Slack workspace

#### Inputs

| Field              | Type            | Required | Description                                                                     |
| ------------------ | --------------- | -------- | ------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | Select a channel to list files from. Options load from the selected connection. |
| File ID            | select (string) | Yes      | The Slack file ID to delete. Options load from the selected connection.         |

#### Outputs

| Field           | Type    | Description                                |
| --------------- | ------- | ------------------------------------------ |
| Delete Success  | boolean | Whether the file was successfully deleted. |
| Deleted File ID | string  | The ID of the file that was deleted.       |
| Result Message  | string  | A confirmation message about the deletion. |

### Upload File to Slack

Upload files to Slack. Supports URLs, base64 content, and text with single channel sharing.

#### Inputs

| Field               | Type            | Required | Description                                                                                                                                                                       |
| ------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Source URL          | string          | No       | URL of the file to upload. The file will be downloaded and uploaded to Slack.                                                                                                     |
| Base64 File Content | string          | No       | Base64 encoded file content (typically from file nodes).                                                                                                                          |
| Text Content        | string          | No       | Raw text content to upload as a file. Will be encoded as UTF-8.                                                                                                                   |
| File Name           | string          | No       | Name of the file. If using source\_url, will be inferred from URL if not provided.                                                                                                |
| Title               | string          | No       | Display title for the file in Slack. Defaults to filename if not provided.                                                                                                        |
| Content Type (MIME) | string          | No       | MIME type of the file. Defaults to 'text/plain' for text mode, 'application/octet-stream' otherwise.                                                                              |
| Channel Name or ID  | select (string) | No       | Channel where the file should be shared. Leave empty to keep file private. Bot must be added to the channel for the message to appear. Options load from the selected connection. |
| Initial Comment     | string          | No       | Message to post alongside the file when sharing to a channel.                                                                                                                     |
| Thread ID           | string          | No       | Thread timestamp to share the file as a reply. Requires channel\_id to be specified.                                                                                              |
| Make Public         | boolean         | No       | If true, create a public link that can be accessed without authentication. Default: false.                                                                                        |

#### Outputs

| Field           | Type    | Description                                                       |
| --------------- | ------- | ----------------------------------------------------------------- |
| Uploaded File   | object  | Information about the uploaded file from Slack API.               |
| Upload Success  | boolean | Whether the file was successfully uploaded to Slack.              |
| Result Message  | string  | Detailed message describing the upload result and sharing status. |
| Shared Channel  | string  | Channel ID where the file was shared, if any.                     |
| Input Mode Used | string  | Which input mode was used for the upload.                         |

### Download Slack File

Download a file from Slack and upload it to temporary storage

#### Inputs

| Field          | Type   | Required | Description                                            |
| -------------- | ------ | -------- | ------------------------------------------------------ |
| Slack File URL | string | Yes      | The Slack file URL to download (from files.slack.com). |

#### Outputs

| Field             | Type   | Description                                           |
| ----------------- | ------ | ----------------------------------------------------- |
| Uploaded File URL | string | The Supabase storage URL where the file was uploaded. |
| File Name         | string | The name of the downloaded file.                      |
| File Size (bytes) | number | Size of the downloaded file in bytes.                 |

### Add Reaction

Add an emoji reaction to a Slack message

#### Inputs

| Field              | Type            | Required | Description                                                                                                                           |
| ------------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel containing the message. Options load from the selected connection.                                                  |
| Message Timestamp  | string          | Yes      | The timestamp of the message to react to. Use the message\_ts from a Send Message action or thread\_id from a trigger.                |
| Emoji Name         | string          | Yes      | The emoji name without colons. Examples: 'eyes' for the looking eyes, 'white\_check\_mark' for a checkmark, 'thumbsup' for thumbs up. |

#### Outputs

| Field             | Type    | Description                                       |
| ----------------- | ------- | ------------------------------------------------- |
| Success           | boolean | Whether the reaction was successfully added.      |
| Channel ID        | string  | The channel ID where the reaction was added.      |
| Message Timestamp | string  | The timestamp of the message that was reacted to. |
| Emoji             | string  | The emoji that was added as a reaction.           |
| Result Message    | string  | A status message about the reaction.              |

### Archive Channel

Archive a Slack channel.

#### Inputs

| Field              | Type            | Required | Description                                                              |
| ------------------ | --------------- | -------- | ------------------------------------------------------------------------ |
| Channel Name or ID | select (string) | Yes      | The Slack channel to archive. Options load from the selected connection. |

#### Outputs

| Field          | Type    | Description                                             |
| -------------- | ------- | ------------------------------------------------------- |
| Success        | boolean | Whether the channel was archived successfully.          |
| Channel ID     | string  | The Slack channel ID involved in the archive operation. |
| Result Message | string  | A status message describing the archive outcome.        |

### Remove Reaction

Remove an emoji reaction from a Slack message

#### Inputs

| Field              | Type            | Required | Description                                                                                                                            |
| ------------------ | --------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel containing the message. Options load from the selected connection.                                                   |
| Message Timestamp  | string          | Yes      | The timestamp of the message to remove the reaction from. Use the message\_ts from a Send Message action or thread\_id from a trigger. |
| Emoji Name         | string          | Yes      | The emoji name to remove, without colons. Examples: 'eyes', 'white\_check\_mark', 'thumbsup'.                                          |

#### Outputs

| Field             | Type    | Description                                                 |
| ----------------- | ------- | ----------------------------------------------------------- |
| Success           | boolean | Whether the reaction was successfully removed.              |
| Channel ID        | string  | The channel ID where the reaction was removed.              |
| Message Timestamp | string  | The timestamp of the message the reaction was removed from. |
| Emoji             | string  | The emoji that was removed.                                 |
| Result Message    | string  | A status message about the reaction removal.                |

### Create Reminder

Create a reminder in Slack.

#### Inputs

| Field           | Type   | Required | Description                                                                                    |
| --------------- | ------ | -------- | ---------------------------------------------------------------------------------------------- |
| Reminder Text   | string | Yes      | Reminder text to be sent by Slack.                                                             |
| Reminder Time   | string | Yes      | When to trigger the reminder. Examples: 'in 30 minutes', 'tomorrow at 9am', or Unix timestamp. |
| User (Optional) | string | No       | Optional target user. If omitted, creates reminder for the authenticated user. Default: .      |

#### Outputs

| Field         | Type    | Description                                    |
| ------------- | ------- | ---------------------------------------------- |
| Success       | boolean | Whether the reminder was created successfully. |
| Reminder ID   | string  | Slack reminder identifier.                     |
| Reminder Text | string  | Stored reminder text.                          |
| Reminder Time | number  | Reminder trigger time as Unix timestamp.       |
| User ID       | string  | Slack user ID who will receive the reminder.   |

### Search Messages

Search for messages in Slack channels using keyword or semantic search. Requires OAuth2 connection.

#### Inputs

| Field        | Type            | Required | Description                                                                                                                                         |
| ------------ | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Search Mode  | select (string) | No       | Choose keyword search (exact text matching) or semantic search (natural language questions). Available values: Keyword, Semantic. Default: keyword. |
| Search Query | string          | Yes      | The search query to find messages. Supports Slack search syntax like exact phrases in quotes.                                                       |
| In Channel   | select (string) | No       | Limit search to a specific channel (optional). Options load from the selected connection.                                                           |
| From User    | string          | No       | Filter by sender (optional). Works with users and bots. Only supported in keyword mode.                                                             |
| Max Results  | number          | No       | Maximum number of messages to return (1-50 keyword, 1-20 semantic, default 20). Minimum: 1. Default: 20.                                            |
| Sort By      | select (string) | No       | Sort results by relevance or timestamp. Available values: Relevance, Newest First, Oldest First. Default: relevance.                                |

#### Outputs

| Field           | Type          | Description                                                  |
| --------------- | ------------- | ------------------------------------------------------------ |
| Messages        | object\_array | List of messages matching the search query.                  |
| Total Matches   | number        | Total number of messages matching the query in Slack.        |
| Query Used      | string        | The final search query sent to Slack (includes all filters). |
| Results Summary | string        | Summary of the search results.                               |

### List Users

List users from the connected Slack workspace.

#### Inputs

| Field                     | Type    | Required | Description                                                      |
| ------------------------- | ------- | -------- | ---------------------------------------------------------------- |
| Include Deactivated Users | boolean | No       | Include deactivated Slack users in the response. Default: false. |
| Include Bot Users         | boolean | No       | Include bot users in the response. Default: false.               |

#### Outputs

| Field       | Type          | Description                               |
| ----------- | ------------- | ----------------------------------------- |
| Users       | object\_array | Workspace users visible to the Slack app. |
| Total Count | number        | Number of users returned.                 |

### Get User Info

Get profile information for a Slack user by ID, email, or username.

#### Inputs

| Field           | Type   | Required | Description                                                         |
| --------------- | ------ | -------- | ------------------------------------------------------------------- |
| User Identifier | string | Yes      | Slack user ID, email, mention, or username/display name to resolve. |

#### Outputs

| Field   | Type   | Description                         |
| ------- | ------ | ----------------------------------- |
| User    | object | Detailed Slack user profile.        |
| Summary | string | Short summary of the resolved user. |

### List Members

List members in an existing Slack channel.

#### Inputs

| Field              | Type            | Required | Description                                                                        |
| ------------------ | --------------- | -------- | ---------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel to list members from. Options load from the selected connection. |
| Ignore Bot Users   | boolean         | No       | Exclude bot users from the returned members. Default: false.                       |

#### Outputs

| Field           | Type          | Description                                                |
| --------------- | ------------- | ---------------------------------------------------------- |
| Channel ID      | string        | The resolved Slack channel ID.                             |
| Member IDs      | array         | List of Slack user IDs in the channel.                     |
| Member Profiles | object\_array | Detailed member profiles including names and role flags.   |
| Total Count     | number        | Number of members returned in this response.               |
| Has More        | boolean       | Whether more members exist beyond the internal return cap. |
| Next Cursor     | string        | Pagination cursor for additional members.                  |

### Get User Status

Get a Slack user's current profile status.

#### Inputs

| Field           | Type   | Required | Description                                                   |
| --------------- | ------ | -------- | ------------------------------------------------------------- |
| User Identifier | string | Yes      | User ID, mention, email, or username/display name to resolve. |

#### Outputs

| Field                        | Type   | Description                                                 |
| ---------------------------- | ------ | ----------------------------------------------------------- |
| User ID                      | string | Resolved Slack user ID.                                     |
| Status Text                  | string | Current Slack status text.                                  |
| Status Emoji                 | string | Current Slack status emoji.                                 |
| Status Expiration            | number | Unix timestamp when status expires (0 means no expiration). |
| Status Expiration (Readable) | string | Human-readable status expiration.                           |

### Set Status

Set the authenticated Slack user's profile status.

#### Inputs

| Field             | Type   | Required | Description                                                                                 |
| ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------- |
| Status Text       | string | Yes      | Status text to display in Slack.                                                            |
| Status Emoji      | string | No       | Optional status emoji in Slack format (e.g., :calendar\_spiral:).                           |
| Status Expiration | string | No       | Optional expiration, e.g. 'in 30 minutes', 'tomorrow 9am', ISO datetime, or Unix timestamp. |

#### Outputs

| Field                        | Type    | Description                                               |
| ---------------------------- | ------- | --------------------------------------------------------- |
| Success                      | boolean | Whether status was set successfully.                      |
| Status Text                  | string  | Applied status text.                                      |
| Status Emoji                 | string  | Applied status emoji.                                     |
| Status Expiration            | number  | Applied expiration timestamp (0 means no expiration).     |
| Status Expiration (Readable) | string  | Human-readable expiration rendered in the timezone\_used. |
| Timezone Used                | string  | Timezone used to parse/render expiration values.          |
| Result Message               | string  | Human-readable update result.                             |

### Invite User to Channel

Add a user to an existing Slack channel.

#### Inputs

| Field              | Type            | Required | Description                                                                                                                                      |
| ------------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Channel Name or ID | select (string) | Yes      | An existing Slack channel to add the user to. The Slack app must already be a member of this channel. Options load from the selected connection. |
| User Identifier    | string          | Yes      | User ID, mention, email, or username/display name to invite.                                                                                     |

#### Outputs

| Field          | Type    | Description                                  |
| -------------- | ------- | -------------------------------------------- |
| Success        | boolean | Whether the user was invited successfully.   |
| Channel ID     | string  | The channel ID where the user was invited.   |
| User ID        | string  | The resolved Slack user ID that was invited. |
| Result Message | string  | Status message describing the invite result. |

### Delete Message

Delete a message from a Slack channel

#### Inputs

| Field              | Type            | Required | Description                                                                                               |
| ------------------ | --------------- | -------- | --------------------------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel containing the message to delete. Options load from the selected connection.            |
| Message Timestamp  | string          | Yes      | The timestamp of the message to delete. Use the message\_ts from a Send Message action or trigger output. |

#### Outputs

| Field             | Type    | Description                                   |
| ----------------- | ------- | --------------------------------------------- |
| Success           | boolean | Whether the message was successfully deleted. |
| Channel ID        | string  | The channel ID where the message was deleted. |
| Message Timestamp | string  | The timestamp of the deleted message.         |
| Result Message    | string  | A status message about the deletion.          |

### Get Reactions

Get all reactions on a Slack message

#### Inputs

| Field              | Type            | Required | Description                                                                                                           |
| ------------------ | --------------- | -------- | --------------------------------------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel containing the message. Options load from the selected connection.                                  |
| Message Timestamp  | string          | Yes      | The timestamp of the message to get reactions from. Use the message\_ts from a Send Message action or trigger output. |

#### Outputs

| Field             | Type          | Description                                                                                                       |
| ----------------- | ------------- | ----------------------------------------------------------------------------------------------------------------- |
| Channel ID        | string        | The channel ID where the message is located.                                                                      |
| Message Timestamp | string        | The timestamp of the message.                                                                                     |
| Reactions         | object\_array | List of reactions on the message. Each reaction includes the emoji name, count, and list of user IDs who reacted. |
| Total Reactions   | number        | Total count of all reactions on the message.                                                                      |

### Get Thread Context

Get all messages from a Slack thread including the parent message and replies

#### Inputs

| Field              | Type            | Required | Description                                                                                       |
| ------------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel containing the thread. Options load from the selected connection.               |
| Thread ID          | string          | Yes      | The thread ID is the timestamp of the thread's parent message. Use Thread ID from trigger output. |
| Max Messages       | integer         | No       | Maximum number of thread messages to return. Defaults to 200, max 1000. Default: 200.             |

#### Outputs

| Field           | Type          | Description                                                                                                          |
| --------------- | ------------- | -------------------------------------------------------------------------------------------------------------------- |
| Channel ID      | string        | The channel ID where the thread is located.                                                                          |
| Thread ID       | string        | The thread ID (timestamp of the thread's parent message).                                                            |
| Thread Messages | object\_array | List of messages in the thread. The first element is the parent message, followed by replies in chronological order. |
| Total Messages  | number        | Total number of messages returned from the thread.                                                                   |
| Has More        | boolean       | Whether the thread has more messages beyond the limit.                                                               |

### Update Message

Update an existing message in a Slack channel

#### Inputs

| Field                   | Type            | Required | Description                                                                                                                                                                                       |
| ----------------------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Channel Name or ID      | select (string) | Yes      | The Slack channel containing the message to update. Options load from the selected connection.                                                                                                    |
| Original Message ID     | string          | Yes      | The unique ID of the message to update. Connect this to the 'Message Timestamp' output from a Send Message action.                                                                                |
| Updated Message Content | textarea        | Yes      | The new message text that will replace the original. Supports Markdown: **bold**, *italic*, ~~strikethrough~~, \`code\`, \`\`\`code blocks\`\`\`, # headings, - bullets, and `[text](url)` links. |

#### Outputs

| Field             | Type    | Description                                   |
| ----------------- | ------- | --------------------------------------------- |
| Success           | boolean | Whether the message was successfully updated. |
| Channel ID        | string  | The channel ID where the message was updated. |
| Message Timestamp | string  | The timestamp of the updated message.         |
| Result Message    | string  | A status message about the update operation.  |

### Start Thread Progress Cards

Post the first progress card in a Slack thread. Use before LLM or tool nodes; pair with Add Thread Progress Card and Finish Thread Progress Cards.

#### Inputs

| Field                                       | Type            | Required | Description                                                                                                                                                                   |
| ------------------------------------------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Channel                                     | select (string) | Yes      | Channel the Thread Progress Cards message will post into. Options load from the selected connection.                                                                          |
| Thread                                      | string          | Yes      | Parent thread to post under. Wire from a Slack trigger's thread\_id output. Thread Progress Cards only render as thread replies.                                              |
| Recipient User (required for channels)      | string          | No       | User being replied to. Wire from a Slack trigger's user\_id output. Required when posting in a channel, optional in DMs. Default: .                                           |
| Recipient Workspace (required for channels) | string          | No       | Workspace ID. Wire from a Slack trigger's team\_id output. Required when posting in a channel, optional in DMs. Default: .                                                    |
| Step ID (optional)                          | string          | No       | Stable identifier for this card. Reuse it in later 'Add Thread Progress Card' nodes to update the same card (e.g., flip In Progress → Complete). Leave blank for a random ID. |
| Step Title                                  | string          | Yes      | Title shown on the first card.                                                                                                                                                |
| Status                                      | select (string) | No       | Status icon on the card. Defaults to In Progress. Available values: In Progress, Complete, Error. Default: in\_progress.                                                      |
| Details (optional)                          | textarea        | No       | Detail text shown under the title. Limit: 251 characters.                                                                                                                     |
| Layout                                      | select (string) | No       | Timeline stacks cards as they happen. Plan groups them into a panel. Available values: Timeline, Plan.                                                                        |

#### Outputs

| Field        | Type   | Description                                                                                                                    |
| ------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| Channel ID   | string | Channel the Thread Progress Cards message was posted into.                                                                     |
| Streaming ID | string | ID of the Thread Progress Cards message. Wire into Add Thread Progress Card and Finish Thread Progress Cards nodes.            |
| Step ID      | string | ID of the first card. Wire into a later Add Thread Progress Card or Finish Thread Progress Cards node to update the same card. |

### Add Thread Progress Card

Add or update a progress card in an active Thread Progress Cards message. Reuse a Step ID to flip a previous card's status.

#### Inputs

| Field              | Type            | Required | Description                                                                                                              |
| ------------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| Channel ID         | string          | Yes      | Channel of the Thread Progress Cards message. Wire from Start Thread Progress Cards' channel\_id output.                 |
| Streaming ID       | string          | Yes      | Message ID of the Thread Progress Cards to add to. Wire from Start Thread Progress Cards' stream\_ts output.             |
| Step ID (optional) | string          | No       | Reuse an earlier Step ID to UPDATE that card (e.g., flip In Progress → Complete). Leave blank to post a new card.        |
| Step Title         | string          | Yes      | Title shown on the card.                                                                                                 |
| Status             | select (string) | No       | Status icon on the card. Defaults to In Progress. Available values: In Progress, Complete, Error. Default: in\_progress. |
| Details (optional) | textarea        | No       | Detail text under the title. Limit: 251 characters.                                                                      |

#### Outputs

| Field   | Type    | Description                                                             |
| ------- | ------- | ----------------------------------------------------------------------- |
| Success | boolean | True if the card was added or updated.                                  |
| Step ID | string  | ID of the card. Wire into later Add or Finish nodes to update it again. |

### Finish Thread Progress Cards

Close a Thread Progress Cards message with a final card. Post the real response separately via Send Message.

#### Inputs

| Field                    | Type            | Required | Description                                                                                                             |
| ------------------------ | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| Channel ID               | string          | Yes      | Channel of the Thread Progress Cards message. Wire from Start Thread Progress Cards' channel\_id output.                |
| Streaming ID             | string          | Yes      | Message ID of the Thread Progress Cards to close. Wire from Start Thread Progress Cards' stream\_ts output.             |
| Final Step ID (optional) | string          | No       | Reuse an earlier Step ID to replace that card with the final one. Leave blank to post a new terminal card.              |
| Final Step Title         | string          | Yes      | Title shown on the final card. Post your real response with a separate 'Send Message' in the same thread.               |
| Final Status             | select (string) | No       | Status icon on the final card. Defaults to Complete. Available values: In Progress, Complete, Error. Default: complete. |
| Final Details (optional) | textarea        | No       | Detail text on the final card. Limit: 251 characters.                                                                   |

#### Outputs

| Field             | Type    | Description                                           |
| ----------------- | ------- | ----------------------------------------------------- |
| Channel ID        | string  | Channel of the closed Thread Progress Cards message.  |
| Message Timestamp | string  | Message ID of the closed Thread Progress Cards.       |
| Success           | boolean | True if the Thread Progress Cards message was closed. |
| Step ID           | string  | ID of the terminal card.                              |

### Set Assistant Status

Show 'is thinking...' with the bot-name shimmer in a Slack Assistant thread. Requires the Slack app to be registered as an Assistant. Clears when the bot next posts in the thread.

#### Inputs

| Field                                         | Type     | Required | Description                                                                                                                                                   |
| --------------------------------------------- | -------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Channel ID                                    | string   | Yes      | Channel of the Assistant thread. Wire from a Slack trigger's channel\_id output.                                                                              |
| Thread                                        | string   | Yes      | Parent thread to set the status on. Wire from a Slack trigger's thread\_id output.                                                                            |
| Rotating Agentic Status (one phrase per line) | textarea | No       | Animated phrases Slack cycles under the composer to narrate the agent's status (e.g., Searching → Analyzing → Drafting). Up to 10 lines, one phrase per line. |
| Typing Indicator                              | string   | No       | Lightweight single phrase shown under the composer, like a typing indicator (e.g., 'is thinking...'). Defaults to 'is thinking...'. Default: is thinking....  |

#### Outputs

| Field   | Type    | Description                 |
| ------- | ------- | --------------------------- |
| Success | boolean | True if the status was set. |

### Join Channel

Join a public Slack channel.

#### Inputs

| Field              | Type            | Required | Description                                                                  |
| ------------------ | --------------- | -------- | ---------------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The public Slack channel to join. Options load from the selected connection. |

#### Outputs

| Field          | Type    | Description                                   |
| -------------- | ------- | --------------------------------------------- |
| Success        | boolean | Whether the channel was joined successfully.  |
| Channel ID     | string  | The Slack channel ID that was joined.         |
| Result Message | string  | A status message describing the join outcome. |

### Leave Channel

Leave a Slack channel.

#### Inputs

| Field              | Type            | Required | Description                                                            |
| ------------------ | --------------- | -------- | ---------------------------------------------------------------------- |
| Channel Name or ID | select (string) | Yes      | The Slack channel to leave. Options load from the selected connection. |

#### Outputs

| Field          | Type    | Description                                    |
| -------------- | ------- | ---------------------------------------------- |
| Success        | boolean | Whether the channel was left successfully.     |
| Channel ID     | string  | The Slack channel ID that was left.            |
| Result Message | string  | A status message describing the leave outcome. |

### Schedule Message

Schedule a Slack message to be sent at a future time.

#### Inputs

| Field                 | Type            | Required | Description                                                                                   |
| --------------------- | --------------- | -------- | --------------------------------------------------------------------------------------------- |
| Channel Name or ID    | select (string) | Yes      | The Slack channel to schedule the message in. Options load from the selected connection.      |
| Message               | textarea        | Yes      | The message text to schedule.                                                                 |
| Send At               | string          | Yes      | When to send the message, as an ISO 8601 datetime. Must be in the future and within 120 days. |
| Thread ID to Reply in | string          | No       | Optionally schedule the message as a reply in this thread.                                    |

#### Outputs

| Field                | Type    | Description                                       |
| -------------------- | ------- | ------------------------------------------------- |
| Success              | boolean | Whether the message was scheduled successfully.   |
| Channel ID           | string  | The Slack channel the message is scheduled for.   |
| Scheduled Message ID | string  | The ID of the scheduled message.                  |
| Scheduled Timestamp  | number  | The Unix timestamp when the message will be sent. |
| Result Message       | string  | A status message describing the outcome.          |

## Triggers

A trigger starts a workflow when its configured event occurs. Configure the event and filters before enabling the trigger.

### On App Mention

Trigger a workflow execution every time the bot is mentioned in a Slack channel. For DM monitoring, use 'On New Message' trigger instead.

Paste this URL into your Slack app's **Event Subscriptions** settings: {{webhook\_url}} **Setup steps:** 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and select your app. 2. Open **Event Subscriptions** and toggle **Enable Events** on. 3. Paste the URL above into the **Request URL** field. Slack will verify the endpoint automatically. 4. Under **Subscribe to bot events**, add the `app_mention` event. 5. Click **Save Changes**. Reinstall the app if Slack prompts you to.

#### Configuration

| Field                       | Type                      | Required | Description                                                                                                                       |
| --------------------------- | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Channels                    | multiple\_select (string) | No       | Optional filter to specific channels (leave empty to monitor all accessible channels). Options load from the selected connection. |
| Ignore Bot Messages         | boolean                   | No       | Skip mentions posted by bots. Default: true.                                                                                      |
| Enable Followups in Threads | boolean                   | No       | If enabled, the workflow will respond to any thread reply to a mention of the bot. Default: false.                                |

#### Event inputs

| Field             | Type        | Required | Description                                                    |
| ----------------- | ----------- | -------- | -------------------------------------------------------------- |
| User ID           | string      | Yes      | The ID of the user who mentioned the bot.                      |
| Username          | string      | No       | The username of the user who mentioned the bot. Default: .     |
| Channel ID        | string      | Yes      | The ID of the channel where the mention occurred.              |
| Channel Name      | string      | No       | The name of the channel where the mention occurred. Default: . |
| Message Text      | string      | Yes      | The text of the message that mentioned the bot.                |
| Message Timestamp | string      | Yes      | The timestamp of the message.                                  |
| Thread ID         | string      | No       | The ID of the thread where the mention occurred. Default: .    |
| Team ID           | string      | No       | The ID of the Slack workspace/team. Default: .                 |
| Attached Files    | dict\_array | No       | List of files attached to the message that mentioned the bot.  |

#### Outputs

| Field             | Type        | Description                                                   |
| ----------------- | ----------- | ------------------------------------------------------------- |
| User ID           | string      | The ID of the user who mentioned the bot.                     |
| Username          | string      | The username of the user who mentioned the bot.               |
| Channel ID        | string      | The ID of the channel where the mention occurred.             |
| Channel Name      | string      | The name of the channel where the mention occurred.           |
| Message Text      | string      | The text of the message that mentioned the bot.               |
| Message Timestamp | string      | The timestamp of the message.                                 |
| Thread ID         | string      | The ID of the thread where the mention occurred.              |
| Team ID           | string      | The ID of the Slack workspace/team.                           |
| Attached Files    | dict\_array | List of files attached to the message that mentioned the bot. |

### On New Message

Fires when a new message is posted in a public channel, private channel, DM, or group DM.

Paste this URL into your Slack app's **Event Subscriptions** settings: {{webhook\_url}} **Setup steps:** 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and select your app. 2. Open **Event Subscriptions** and toggle **Enable Events** on. 3. Paste the URL above into the **Request URL** field. Slack will verify the endpoint automatically. 4. Under **Subscribe to bot events**, add the `message.channels` event. Also add `message.im`, `message.groups`, or `message.mpim` if your workflow should monitor DMs, private channels, or group DMs. 5. Click **Save Changes**. Reinstall the app if Slack prompts you to.

#### Configuration

| Field               | Type                      | Required | Description                                                                                                                       |
| ------------------- | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Channels            | multiple\_select (string) | No       | Optional filter to specific channels (leave empty to monitor all accessible channels). Options load from the selected connection. |
| Ignore Bot Messages | boolean                   | No       | Skip messages posted by bots. Default: true.                                                                                      |
| Threads Only        | boolean                   | No       | Only trigger on messages that are part of a thread. Default: false.                                                               |

#### Event inputs

| Field             | Type        | Required | Description                                                               |
| ----------------- | ----------- | -------- | ------------------------------------------------------------------------- |
| User ID           | string      | Yes      | The ID of the user who posted the message.                                |
| Channel ID        | string      | Yes      | The ID of the channel where the message was posted.                       |
| Channel Name      | string      | No       | The name of the channel where the message was posted. Default: .          |
| Message Text      | string      | Yes      | The text content of the message.                                          |
| Message Timestamp | string      | Yes      | The timestamp of the message.                                             |
| Thread Timestamp  | string      | No       | The timestamp of the parent message if this is a thread reply. Default: . |
| Channel Type      | string      | No       | The type of channel (channel, group, im, mpim). Default: channel.         |
| Team ID           | string      | No       | The ID of the Slack workspace/team. Default: .                            |
| Is Bot Message    | boolean     | No       | Whether the message was posted by a bot. Default: false.                  |
| Attached Files    | dict\_array | No       | List of files attached to the message.                                    |

#### Outputs

| Field             | Type        | Description                                                    |
| ----------------- | ----------- | -------------------------------------------------------------- |
| User ID           | string      | The ID of the user who posted the message.                     |
| Channel ID        | string      | The ID of the channel where the message was posted.            |
| Channel Name      | string      | The name of the channel where the message was posted.          |
| Message Text      | string      | The text content of the message.                               |
| Message Timestamp | string      | The timestamp of the message.                                  |
| Thread Timestamp  | string      | The timestamp of the parent message if this is a thread reply. |
| Channel Type      | string      | The type of channel (channel, group, im, mpim).                |
| Team ID           | string      | The ID of the Slack workspace/team.                            |
| Is Bot Message    | boolean     | Whether the message was posted by a bot.                       |
| Attached Files    | dict\_array | List of files attached to the message.                         |

### On New Message (Polling)

Fires when a new message is posted in a public channel using periodic polling.

#### Configuration

| Field               | Type                      | Required | Description                                                                                                                       |
| ------------------- | ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------- |
| Channels            | multiple\_select (string) | No       | Optional filter to specific channels (leave empty to monitor all accessible channels). Options load from the selected connection. |
| Ignore Bot Messages | boolean                   | No       | Skip messages posted by bots. Default: true.                                                                                      |
| Threads Only        | boolean                   | No       | Only trigger on messages that are part of a thread. Default: false.                                                               |

#### Event inputs

| Field             | Type        | Required | Description                                                               |
| ----------------- | ----------- | -------- | ------------------------------------------------------------------------- |
| User ID           | string      | Yes      | The ID of the user who posted the message.                                |
| Channel ID        | string      | Yes      | The ID of the channel where the message was posted.                       |
| Channel Name      | string      | No       | The name of the channel where the message was posted. Default: .          |
| Message Text      | string      | Yes      | The text content of the message.                                          |
| Message Timestamp | string      | Yes      | The timestamp of the message.                                             |
| Thread Timestamp  | string      | No       | The timestamp of the parent message if this is a thread reply. Default: . |
| Channel Type      | string      | No       | The type of channel (channel, group, im, mpim). Default: channel.         |
| Team ID           | string      | No       | The ID of the Slack workspace/team. Default: .                            |
| Is Bot Message    | boolean     | No       | Whether the message was posted by a bot. Default: false.                  |
| Attached Files    | dict\_array | No       | List of files attached to the message.                                    |

#### Outputs

| Field             | Type        | Description                                                    |
| ----------------- | ----------- | -------------------------------------------------------------- |
| User ID           | string      | The ID of the user who posted the message.                     |
| Channel ID        | string      | The ID of the channel where the message was posted.            |
| Channel Name      | string      | The name of the channel where the message was posted.          |
| Message Text      | string      | The text content of the message.                               |
| Message Timestamp | string      | The timestamp of the message.                                  |
| Thread Timestamp  | string      | The timestamp of the parent message if this is a thread reply. |
| Channel Type      | string      | The type of channel (channel, group, im, mpim).                |
| Team ID           | string      | The ID of the Slack workspace/team.                            |
| Is Bot Message    | boolean     | Whether the message was posted by a bot.                       |
| Attached Files    | dict\_array | List of files attached to the message.                         |

### On Public Channel Created

Triggers when a new public channel is created in the Slack workspace.

Paste this URL into your Slack app's **Event Subscriptions** settings: {{webhook\_url}} **Setup steps:** 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and select your app. 2. Open **Event Subscriptions** and toggle **Enable Events** on. 3. Paste the URL above into the **Request URL** field. Slack will verify the endpoint automatically. 4. Under **Subscribe to bot events**, click **Add Bot User Event** and add the `channel_created` event. This requires the `channels:read` OAuth scope on your bot token. 5. Click **Save Changes**. Reinstall the app if Slack prompts you to.

#### Event inputs

| Field             | Type    | Required | Description                                    |
| ----------------- | ------- | -------- | ---------------------------------------------- |
| Channel ID        | string  | Yes      | The ID of the newly created channel.           |
| Channel Name      | string  | Yes      | The name of the newly created channel.         |
| Created At (Unix) | integer | Yes      | Unix timestamp when the channel was created.   |
| Creator User ID   | string  | Yes      | The ID of the user who created the channel.    |
| Team ID           | string  | No       | The ID of the Slack workspace/team. Default: . |

#### Outputs

| Field             | Type    | Description                                                |
| ----------------- | ------- | ---------------------------------------------------------- |
| Channel ID        | string  | The ID of the newly created channel.                       |
| Channel Name      | string  | The name of the newly created channel.                     |
| Created At (Unix) | integer | Unix timestamp when the channel was created.               |
| Created At (ISO)  | string  | ISO 8601 formatted timestamp when the channel was created. |
| Creator User ID   | string  | The ID of the user who created the channel.                |
| Team ID           | string  | The ID of the Slack workspace/team.                        |

### On Reaction Added

Fires when someone adds an emoji reaction to a message in Slack.

Paste this URL into your Slack app's **Event Subscriptions** settings: {{webhook\_url}} **Setup steps:** 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and select your app. 2. Open **Event Subscriptions** and toggle **Enable Events** on. 3. Paste the URL above into the **Request URL** field. Slack will verify the endpoint automatically. 4. Under **Subscribe to bot events**, add the `reaction_added` event. 5. Click **Save Changes**. Reinstall the app if Slack prompts you to.

#### Configuration

| Field           | Type                      | Required | Description                                                                                                          |
| --------------- | ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------- |
| Channels        | multiple\_select (string) | No       | Filter to specific channels. Leave empty to monitor all channels. Options load from the selected connection.         |
| Reactions       | string                    | No       | Comma-separated emoji names to filter. Leave empty for any reaction.                                                 |
| Message Authors | string                    | No       | Comma-separated user identifiers. Only trigger for reactions on messages by these users. Leave empty for any author. |

#### Event inputs

| Field                   | Type    | Required | Description                                                                     |
| ----------------------- | ------- | -------- | ------------------------------------------------------------------------------- |
| User ID                 | string  | Yes      | The ID of the user who added the reaction.                                      |
| Username                | string  | No       | The display name of the user who added the reaction. Default: .                 |
| Reaction                | string  | Yes      | The emoji reaction that was added (e.g., thumbsup).                             |
| Channel ID              | string  | Yes      | The ID of the channel where the reaction was added.                             |
| Channel Name            | string  | No       | The name of the channel where the reaction was added. Default: .                |
| Message Timestamp       | string  | Yes      | The timestamp of the message that received the reaction.                        |
| Message Text            | string  | No       | The text content of the message that received the reaction. Default: .          |
| Message Author ID       | string  | No       | The ID of the user who wrote the message that received the reaction. Default: . |
| Message Author Username | string  | No       | The display name of the user who wrote the message. Default: .                  |
| Event Timestamp         | string  | Yes      | The timestamp when the reaction was added.                                      |
| Team ID                 | string  | No       | The ID of the Slack workspace. Default: .                                       |
| Is Bot Reaction         | boolean | No       | Whether the reaction was added by a bot. Default: false.                        |

#### Outputs

| Field                   | Type    | Description                                                          |
| ----------------------- | ------- | -------------------------------------------------------------------- |
| User ID                 | string  | The ID of the user who added the reaction.                           |
| Username                | string  | The display name of the user who added the reaction.                 |
| Reaction                | string  | The emoji reaction that was added (e.g., thumbsup).                  |
| Channel ID              | string  | The ID of the channel where the reaction was added.                  |
| Channel Name            | string  | The name of the channel where the reaction was added.                |
| Message Timestamp       | string  | The timestamp of the message that received the reaction.             |
| Message Text            | string  | The text content of the message that received the reaction.          |
| Message Author ID       | string  | The ID of the user who wrote the message that received the reaction. |
| Message Author Username | string  | The display name of the user who wrote the message.                  |
| Event Timestamp         | string  | The timestamp when the reaction was added.                           |
| Team ID                 | string  | The ID of the Slack workspace.                                       |
| Is Bot Reaction         | boolean | Whether the reaction was added by a bot.                             |

### On User Joined

Fires when a new user joins the Slack workspace.

Paste this URL into your Slack app's **Event Subscriptions** settings: {{webhook\_url}} **Setup steps:** 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and select your app. 2. Open **Event Subscriptions** and toggle **Enable Events** on. 3. Paste the URL above into the **Request URL** field. Slack will verify the endpoint automatically. 4. Under **Subscribe to bot events**, click **Add Bot User Event** and add the `team_join` event. This requires the `users:read` OAuth scope on your bot token. 5. Click **Save Changes**. Reinstall the app if Slack prompts you to.

#### Event inputs

| Field                   | Type    | Required | Description                                                             |
| ----------------------- | ------- | -------- | ----------------------------------------------------------------------- |
| User ID                 | string  | Yes      | The Slack user ID of the new member.                                    |
| Username                | string  | No       | The username (handle) of the new member. Default: .                     |
| Email                   | string  | No       | The email address of the new member. Default: .                         |
| Real Name               | string  | No       | The full name of the new member. Default: .                             |
| Display Name            | string  | No       | The display name of the new member. Default: .                          |
| Title                   | string  | No       | The job title of the new member. Default: .                             |
| Team ID                 | string  | No       | The Slack workspace/team ID. Default: .                                 |
| Timezone                | string  | No       | The timezone of the new member. Default: .                              |
| Is Admin                | boolean | No       | Whether the new member is a workspace admin. Default: false.            |
| Is Bot                  | boolean | No       | Whether the new member is a bot user. Default: false.                   |
| Is Guest                | boolean | No       | Whether the new member is a guest user (multi-channel). Default: false. |
| Is Single-Channel Guest | boolean | No       | Whether the new member is a single-channel guest. Default: false.       |
| Avatar URL              | string  | No       | URL to the user's avatar image (512px). Default: .                      |
| Event Timestamp         | string  | No       | The timestamp when the user joined. Default: .                          |

#### Outputs

| Field                   | Type    | Description                                       |
| ----------------------- | ------- | ------------------------------------------------- |
| User ID                 | string  | The Slack user ID of the new member.              |
| Username                | string  | The username (handle) of the new member.          |
| Email                   | string  | The email address of the new member.              |
| Real Name               | string  | The full name of the new member.                  |
| Display Name            | string  | The display name of the new member.               |
| Title                   | string  | The job title of the new member.                  |
| Team ID                 | string  | The Slack workspace/team ID.                      |
| Timezone                | string  | The timezone of the new member.                   |
| Is Admin                | boolean | Whether the new member is a workspace admin.      |
| Is Bot                  | boolean | Whether the new member is a bot user.             |
| Is Guest                | boolean | Whether the new member is a guest user.           |
| Is Single-Channel Guest | boolean | Whether the new member is a single-channel guest. |
| Avatar URL              | string  | URL to the user's avatar image.                   |
| Event Timestamp         | string  | The timestamp when the user joined.               |

### On User Mentioned

Fires when a specific user is @mentioned in a Slack message.

Paste this URL into your Slack app's **Event Subscriptions** settings: {{webhook\_url}} **Setup steps:** 1. Go to [api.slack.com/apps](https://api.slack.com/apps) and select your app. 2. Open **Event Subscriptions** and toggle **Enable Events** on. 3. Paste the URL above into the **Request URL** field. Slack will verify the endpoint automatically. 4. Under **Subscribe to bot events**, add the `message.channels` event. Also add `message.im`, `message.groups`, or `message.mpim` if your workflow should monitor DMs, private channels, or group DMs. 5. Click **Save Changes**. Reinstall the app if Slack prompts you to.

#### Configuration

| Field               | Type                      | Required | Description                                                                                                   |
| ------------------- | ------------------------- | -------- | ------------------------------------------------------------------------------------------------------------- |
| Users to Watch      | multiple\_select (string) | Yes      | Select users to monitor for @mentions. Options load from the selected connection.                             |
| Channels (Optional) | multiple\_select (string) | No       | Optional filter to specific channels (leave empty to monitor all). Options load from the selected connection. |
| Ignore Bot Messages | boolean                   | No       | Skip mentions posted by bots. Default: true.                                                                  |

#### Event inputs

| Field              | Type        | Required | Description                                                       |
| ------------------ | ----------- | -------- | ----------------------------------------------------------------- |
| Mentioned User ID  | string      | Yes      | The user ID of the mentioned user.                                |
| Mentioned Username | string      | No       | The username of the mentioned user. Default: .                    |
| Sender User ID     | string      | Yes      | The user ID of who sent the message.                              |
| Sender Username    | string      | No       | The username of who sent the message. Default: .                  |
| Channel ID         | string      | Yes      | The channel where the mention occurred.                           |
| Channel Name       | string      | No       | The name of the channel. Default: .                               |
| Channel Type       | string      | No       | The type of channel (channel, group, im, mpim). Default: channel. |
| Message Text       | string      | Yes      | The full text of the message containing the mention.              |
| Message Timestamp  | string      | Yes      | The timestamp of the message.                                     |
| Thread Timestamp   | string      | No       | The thread timestamp if this is a reply. Default: .               |
| Team ID            | string      | No       | The Slack workspace/team ID. Default: .                           |
| Is Bot Message     | boolean     | No       | Whether the message was sent by a bot. Default: false.            |
| Attached Files     | dict\_array | No       | List of files attached to the message.                            |

#### Outputs

| Field              | Type        | Description                              |
| ------------------ | ----------- | ---------------------------------------- |
| Mentioned User ID  | string      | The user ID of the mentioned user.       |
| Mentioned Username | string      | The username of the mentioned user.      |
| Sender User ID     | string      | The user ID of who sent the message.     |
| Sender Username    | string      | The username of who sent the message.    |
| Channel ID         | string      | The channel where the mention occurred.  |
| Channel Name       | string      | The name of the channel.                 |
| Channel Type       | string      | The type of channel.                     |
| Message Text       | string      | The full text of the message.            |
| Message Timestamp  | string      | The timestamp of the message.            |
| Thread Timestamp   | string      | The thread timestamp if this is a reply. |
| Team ID            | string      | The Slack workspace/team ID.             |
| Is Bot Message     | boolean     | Whether the message was sent by a bot.   |
| Attached Files     | dict\_array | List of files attached to the message.   |

## Important behavior

If an operation is denied, check the connection’s granted permissions and the account’s access in the provider. Reauthorize the connection when it needs additional permissions.

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/slack.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
