Slack

Overview

Slack is the world's leading team collaboration and instant messaging platform, providing real-time messaging, file sharing, channel management, and integration features for enterprises and teams. Through the Slack API, developers can access and manage core business objects such as messages, channels, users, and files, achieving deep team collaboration system integration.

Through GoInsight's Slack node, you can seamlessly integrate team collaboration capabilities into your automated workflows. You can automate team communication and related data, including:

• Message Management: Send and update messages, delete messages, thread replies, permalinks, channel history, and thread retrieval
• Channel Management: Create, configure, unarchive channels (topic, purpose, rename), join or leave channels, open DMs, and close conversations
• User Management: Look up users, list workspace members, read user details (Get Information about a User), dedicated Get a User Profile, and check presence status
• File Management: List files and read single-file metadata (Get Many Files, Get a File)
• Interactive Features: Add, list, and remove emoji reactions on messages
• Real-time Notifications: Send a message and wait for a reply for lightweight interactive flows
• User Groups: List user groups (Get Many User Groups)

Prerequisites

Before using this node, you need to meet the following conditions:

• Token type (GoInsight): The integration uses a Bot User OAuth Token (xoxb-) only. A User OAuth Token (xoxp-) is not supplied and cannot be configured on the service side—automations must rely on bot-token capabilities (for example, Update a Message only applies to messages the same bot posted).
• Account Requirement: You need to have a valid Slack workspace account
• App Permissions: You need to create a Slack app and obtain the corresponding OAuth permission scopes
• API Access: You need API access permissions and the corresponding Bot Token
• Channel Permissions: You need to ensure the bot is invited to the channels it needs to operate on

Credentials

For detailed guidance on how to obtain and configure credentials, please refer to our official documentation: Credentials Configuration Guide.

Supported Operations

Summary

This node operates on messages, channels (including unarchive), channel members, files, reactions, users, and user groups—scoped to the 31 operations shown in the GoInsight action picker (alphabetical list below).

Shipped operations (31)

The checklist follows the current picker labels (including known typos on items 11 and 16). Canonical doc titles and anchors use corrected spelling; each section calls out picker wording where it differs.

Other UI labels: Get Thread Messages may appear as Get a Thread of Messages Posted to a Channel; Send Message and Wait may appear as Send a Message and Wait Response.

1. Add a Reaction
2. Close a Channel
3. Create a Channel
4. Delete a Message
5. Get a Channel
6. Get a File
7. Get a Message Permalink
8. Get a Reaction
9. Get a User Presence Status
10. Get a User Profile
11. Get Infomation about a User — picker spelling; canonical Get Information about a User
12. Get Many Channels
13. Get Many Files
14. Get Many User Groups
15. Get Many Users
16. Get Mambers of a Channel — picker spelling; canonical Get Members of a Channel
17. Get the History of a Channel
18. Get Thread Messages
19. Invite a User to a Channel
20. Join a Channel
21. Kick a User from a Channel
22. Leave a Channel
23. Open a Channel
24. Remove a Reaction
25. Rename a Channel
26. Send a Message
27. Send Message and Wait
28. Set the Purpose of a Channel
29. Set the Topic of a Channel
30. Unarchive a Channel
31. Update a Message

The following table groups the same 31 operations by resource for scanning.

Example Usage

This section will guide you through creating a simple workflow to send a message to a Slack channel.

Workflow Overview

This example workflow consists of: Start -> Slack Send a Message -> Answer

Step-by-Step Guide

1. Add Tool Node:
   • In the workflow canvas, click the "+" button to add a new node
   • Select the "Tools" tab in the pop-up panel
   • Find and select Slack in the tools list
   • In the Slack supported operations list, click to select Send a Message, which will add a corresponding node to the canvas
2. Configure Node:
   • Click the newly added Send a Message node, and the configuration panel for this node will expand on the right side
   • Credentials Configuration: At the top of the panel, find the credentials field. Click the dropdown menu and select your configured Slack credentials
   • Parameter Filling:
   • Channel: Enter the channel ID to send the message to, such as C1234567890. You can right-click on a channel name in Slack and select "Copy link" to get the channel ID
   • Text: Enter the message content to send, such as Hello from GoInsight! 🚀 Workflow executed successfully!
   • Supports Slack's markdown format, such as *bold*, _italic_, ~strikethrough~, etc.
   • Can use @channel or @here to mention all members
   • Supports emoji, such as 🙂, :rocket:, :thumbsup:, etc.
3. Run and Verify:
   • When all required parameters are filled in correctly, the error message in the upper right corner of the workflow canvas will disappear
   • Click the "Test Run" button in the upper right corner of the canvas to execute the workflow
   • After successful execution, you can click the log icon in the upper right corner to view the detailed input and output of the node and verify whether the message was sent successfully
   • Meanwhile, you can check the specified channel in the Slack app to confirm the message was successfully sent

After completing the above steps, your entire workflow is configured. Click 'Test Run', and a message will be successfully sent to your specified Slack channel.

FAQs

Q: Why am I receiving authentication errors?

A: Please check the following:

• Confirm whether your Slack Bot Token is correct and valid
• Check whether your Slack app is installed in the workspace
• Confirm whether your bot has the corresponding OAuth permission scopes
• Verify whether the Bot Token starts with xoxb-

Q: Why can't I send messages to a channel?

A: Please ensure the following conditions are met:

• Channel Permissions: The bot must be invited to the target channel
• Channel ID: Ensure you use the correct channel ID format (usually starting with C)
• Permission Scopes: Confirm your app has the chat:write permission
• Channel Type: Private channels require explicitly inviting the bot to join

Q: How do I get a channel ID?

A: Methods to get channel ID:

• Method 1: In Slack, right-click on the channel name, select "Copy link", the link contains the channel ID
• Method 2: In a channel, enter a message, right-click on the message and select "Copy link", the link contains the channel ID
• Method 3: Use the "Get Many Channels" operation to get a list of all channels and their IDs
• Channel ID Format: Public channels usually start with C, private channels start with G, DM channels start with D

Q: How do I work with files in Slack?

A: This integration supports listing files and reading file metadata through Get Many Files and Get a File (not uploading binaries through the node):

• List and inspect: Use Get Many Files or Get a File; large workspaces require pagination with the cursor fields where applicable
• Permission Requirements: Typically requires files:read (and related scopes your app is granted)
• Download URLs: Metadata responses may include private URLs; access still follows Slack workspace permissions and token scopes

Q: How do I use message formatting?

A: Slack message formatting syntax:

• Text Formatting: *bold*, _italic_, ~strikethrough~, ` code `
• Link Format: <https://example.com|link text>
• User Mention: <@U1234567890> or <@username>
• Channel Mention: <#C1234567890> or <#channelname>
• Special Mentions: @channel, @here, @everyone
• Emoji: 🙂, :rocket:, :+1:, etc.

Q: How do I work with user groups?

A: Use Get Many User Groups to list groups (optionally with member IDs). User-group create/update/enable/disable actions are not in the current shipped picker set documented here.

• Mentions in messages: Existing groups can still be mentioned using Slack's <!subteam^S1234567890> syntax when you already know the user group ID

Q: How do I handle API rate limits?

A: API rate limit handling:

• Limit Description: Slack API has different tiers of rate limits
• Retry Mechanism: Implement exponential backoff retry strategy
• Batch Operations: Try to use batch APIs to reduce the number of requests
• Monitor Usage: Pay attention to rate limit information in API response headers
• Error Handling: Properly handle 429 status code (Too Many Requests)

Official Documentation

Slack Official API Documentation

Operation Details

Create a Channel

Create a new Slack channel with a specified name and privacy setting. Use this to organize conversations in your workspace. Returns the complete Slack API response. The returned Result.channel.id is the unique identifier of the new channel; use it to chain into other channel-targeting actions. Limitations: Channel names must be lowercase, without spaces, and max 80 characters.

Input Parameters:

• Name: The name of the new Slack channel. Must be lowercase, no spaces, max 80 characters. Example: "project-alpha"

Options:

• IsPrivate: Whether to create a private channel (true) or public channel (false). Default: false

Output:

• Result (object): The complete Slack API response object (pass-through). Key fields on success: 'ok' (bool) — true; 'channel' (object) — the newly created channel, where 'channel.id' is Slack's unique channel identifier. Use this exact 'channel.id' value to target the new channel in any downstream channel action. On failure: 'ok'=false with 'error' string.
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API.
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Detailed error message if any error occurred. Empty string if succeeded.

Get Many Channels

List Slack channels (public/private/MPIM/IM) with filtering and pagination. Returns complete channel objects. Each Channels[].id is reusable as ChannelId in any channel-targeting action. Loop until Pagination.has_more is false, passing Pagination.next_cursor as Cursor.

Options:

• Limit: The maximum number of items to return. Default is 100, maximum is 1000. Example: 100
• Types: Comma-separated list of channel types to include. Supported values: public_channel, private_channel, mpim, im. Example: "public_channel,private_channel"
• ExcludeArchived: Whether to exclude archived channels from the list. Default: false (include archived channels). Example: true
• Cursor: Pagination cursor for fetching the next page. Obtain this value from the previous response's Pagination.next_cursor. Leave empty for the first page. Example: "dGVhbTpDMDYxRkE1UEI="

Output:

• Channels (object-array): Array of complete Slack channel objects (pass-through from API). Each channel object contains all fields returned by Slack API, including id, name, is_channel, is_private, created, creator, topic, purpose, etc.
• Pagination (object): Pagination metadata. Fields: limit, returned_count, next_cursor, has_more.
• OriginalStatusCode (number): The raw HTTP status code returned by Slack API.
• StatusCode (number): The system status code (200 for success).
• ErrorMessage (string): Detailed error message. Includes missing scopes (needed) if applicable.

Get a Channel

Get information about a Slack channel. Use this to retrieve details like name, topic, purpose, and member count. Returns the complete channel object containing id, name, is_private, etc. The returned id can be reused in any other channel action. Limitations: Bot must be in the channel for private channels.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field). Format: 11-character code starting with 'C' (public channel), 'G' (private channel/group), or 'D' (DM), e.g., 'C1234567890'. Do NOT pass channel names like '#general' — only the encoded ID. Example: 'C1234567890'

Output:

• ChannelInfo (object): The complete channel object returned by the Slack API. Key fields: 'id' (string) — Slack's unique channel identifier; 'name' (string) — display name like 'general'; 'is_private' (bool); 'is_archived' (bool); 'is_member' (bool); 'num_members' (number); 'topic' / 'purpose' (objects); 'creator' (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200 for success, 404 for not found).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Set the Purpose of a Channel

Set the purpose (description) of a Slack channel. Not for renaming. Returns the Slack API response with purpose details on success. Limitations: Bot must be a member of the channel.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field). Format: 11-character code starting with 'C' (public) or 'G' (private), e.g., 'C1234567890'. Do NOT pass channel names like '#general'. Example: 'C1234567890'
• Purpose: The new purpose or description for the channel (required). Max length: 250 characters. Supports plain text and Slack mrkdwn.

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true), purpose (string - the new purpose), channel (object with id, name, purpose details). On error, contains: ok (boolean - false), error (string).
• OriginalStatusCode (number): The original HTTP status code returned by the Slack API. Used for debugging.
• StatusCode (number): Operation status code: 200 for success (including business errors), -1 for parameter validation errors, and 500 for system/network errors.
• ErrorMessage (string): Detailed error message if the operation failed. Common Slack errors: 'channel_not_found', 'not_in_channel', 'purpose_too_long'.

Set the Topic of a Channel

Set the topic of a Slack channel. Use this to update the channel's topic banner. Returns the complete Slack API response. Limitations: Maximum topic length is 250 characters. The bot must be a member of the channel to set the topic.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field). Format: 11-character code starting with 'C' (public), 'G' (private), or 'D' (DM), e.g., 'C1234567890'. Do NOT pass channel names like '#general'. Example: 'C1234567890'
• Topic: The new topic text for the channel. Used to describe the channel's purpose or current focus. Supports emojis and special characters. Maximum length is 250 characters. Example: "📢 Weekly Team Sync - Every Monday 10 AM PST"

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true), topic (string - the new topic), channel (object). On error, contains: ok (boolean - false), error (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200).
• StatusCode (number): An HTTP status code indicating the success or failure of the API request.
• ErrorMessage (string): A descriptive error message explaining why the request failed.
• ErrorMessage (string): A descriptive error message explaining why the request failed.

Close a Channel

Close a Slack channel or conversation (DM, group DM). Use this to close DM channels or archive conversations. Returns the complete Slack API response. Limitations: Cannot close #general channel. Most commonly used for DM channels.

Input Parameters:

• ChannelId: Slack channel/conversation's unique identifier (the 'id' field) of the conversation to close. Format: 11-character code starting with 'C' (public channel), 'G' (private channel/group), or 'D' (DM — most common use case for this action), e.g., 'D1234567890'. Do NOT pass channel names like '#general'. Example: 'D1234567890'

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true), no_op (boolean - true if already closed), already_closed (boolean - true if was already closed). On error, contains: ok (boolean - false), error (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API.
• StatusCode (number): Operation status code: 200 for success; -1 for client-side validation errors; 500 for API errors or permission issues.
• ErrorMessage (string): Detailed error message. Common Slack errors: 'channel_not_found', 'cant_close_general', 'not_in_channel'. Empty if successful.

Join a Channel

Join a Slack channel by its ID. Use this to add the bot to a specific channel. This action is idempotent: if the bot is already a member, it succeeds without error. Limitations: Only public channels (starting with 'C') can be joined this way; for private channels, use 'Invite a User to a Channel'. Joining a channel does not trigger system notifications.

Input Parameters:

• Channel: Slack channel's unique identifier (the 'id' field) of the channel to join. Format: 11-character code starting with 'C' (public channel), e.g., 'C1234567890'. Do NOT pass channel names like '#general'. Example: 'C1234567890'

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true), channel (object), already_in_channel (boolean - if was already member). On error, contains: ok (boolean - false), error (string).
• OriginalStatusCode (number): The original HTTP status code returned by the Slack API. Default is 0 if the request failed before reaching the server.
• StatusCode (number): Operation status code: 200 for success (check ErrorMessage for business logic errors), -1 for parameter validation errors, and 500 for system/network errors.
• ErrorMessage (string): Detailed error message from Slack or the system. Empty if the operation was successful.

Leave a Channel

Remove the authenticated user or bot from a Slack channel. Use this when you no longer need access to a channel's messages. The action returns the complete Slack API response object. Note: Leaving private channels requires a new invite to rejoin. Cannot leave #general.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field) of the channel to leave. Format: 11-character code starting with 'C' (public) or 'G' (private), e.g., 'C0123456789'. Do NOT pass channel names like '#general'. Example: 'C0123456789'

Output:

• Result (object): Complete Slack API response object (pass-through). Core fields: ok (boolean) - true if successfully left, false if failed; error (string, only when ok=false) - error code.
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200).
• StatusCode (number): System operation status code. 200 = system healthy, 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Open a Channel

Open a Slack DM (direct message) channel with a user. Returns the Slack API response. Result.channel.id is the DM's unique identifier (a 'D...' ID); use it to chain into 'Send a Message' (to post into the DM), 'Get the History of a Channel' (to read history), or 'Close a Channel'. Limitations: One-on-one DMs only.

Input Parameters:

• UserId: Slack user's unique identifier (the 'id' field) of the person to open a DM with. Format: 11-character code starting with 'U' (regular user) or 'W' (Enterprise Grid user), e.g., 'U01234567AB'. Do NOT pass email addresses or @usernames. Example: 'U01234567AB'

Output:

• Result (object): The complete Slack API response object (pass-through). Key fields on success: 'ok' (bool) — true; 'channel' (object) — the opened DM conversation, where 'channel.id' is Slack's unique identifier for this DM.
• OriginalStatusCode (number): The original HTTP status code returned by Slack API. Default 0 means the request did not reach upstream.
• StatusCode (number): The business status code. 200 for success, 500 for system errors, -1 for validation errors.
• ErrorMessage (string): Detailed error information. If the API returns an error, this field will contain the Slack error code and the HTTP status.

Rename a Channel

Rename a Slack channel. Returns the Slack API response. Naming rules: lowercase, numbers, hyphens, underscores only. Requires channels:manage or groups:write scope. Rate limited.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field) of the channel to rename. Format: 11-character code starting with 'C' (public) or 'G' (private), e.g., 'C1234567890'. Do NOT pass channel names like '#general'. Example: 'C1234567890'
• Name: The new name for the channel. Must follow Slack's naming rules: lowercase letters only, numbers, hyphens (-), and underscores (_) are allowed; no spaces (use hyphens instead); maximum length is 80 characters. Example: "project-alpha-discussion"

Output:

• Result (object): Complete Slack API response object (pass-through). Success: {"ok": true, "channel": {...}} with full channel details. Failure: {"ok": false, "error": "..."}.
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 429, 500).
• StatusCode (number): Standardized operation status code: 200=Success, -1=Parameter validation error, 500=System error or API failure.
• ErrorMessage (string): Detailed error message providing context if the operation failed. Empty string on success.

Unarchive a Channel

Unarchive a Slack channel by ID. Use this to restore a previously archived channel to active status. Returns the complete Slack API response. Limitations: Cannot unarchive a channel that is not archived.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field) of the archived channel to unarchive. Format: 11-character code starting with 'C' (public) or 'G' (private), e.g., 'C1234567890'. Do NOT pass channel names like '#general'. Example: 'C1234567890'

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true). On error, contains: ok (boolean - false), error (string), detail (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API.
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Get Members of a Channel

Product label: This action may appear in the UI as Get Mambers of a Channel (typo); behavior and parameters are as documented here.

Get the list of member user IDs in a Slack channel. For full user details, call 'Get Information about a User' on each ID. Returns the Slack API response with the members array. Each member ID is reusable in other user-targeting actions. Pagination: Use Result.response_metadata.next_cursor to fetch the next page.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field). Format: 11-character code starting with 'C' (public) or 'G' (private), e.g., 'C0123456789'. Do NOT pass channel names like '#general'. Example: 'C0123456789'

Options:

• Cursor: Pagination cursor for retrieving the next page of members. Leave empty for the first request. Use the 'next_cursor' value from 'response_metadata' in the previous response to get the next page. Example: "dXNlcjpVMDYxTkZUVDI="

Output:

• Result (object): The complete Slack API response object (pass-through). Key fields on success: 'ok' (bool) — true; 'members' (array of strings) — Slack user IDs like ['U0123456789', 'U9876543210']; 'response_metadata.next_cursor' (string). On failure: 'ok'=false with 'error' string.
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 404).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Invite a User to a Channel

Invite one or more users to a Slack channel. Returns the Slack API response. Limitations: Bot must be a member of the channel first (use 'Join a Channel' if needed). Max 1000 users per request.

Input Parameters:

• ChannelId: Slack channel's unique identifier (the 'id' field) of the channel to invite users to. Format: 11-character code starting with 'C' (public) or 'G' (private), e.g., 'C1234567890'. Do NOT pass channel names like '#general'. The bot must be a member of the channel. Example: 'C1234567890'
• UserIds: Comma-separated list of Slack user unique identifiers (the user 'id' field). Format: each is an 11-character code starting with 'U' (regular user) or 'W' (Enterprise Grid user), e.g., 'U2147483697,U2147483698'. Do NOT pass usernames or @display_names. Maximum 1000 users per request. Example: 'U2147483697,U2147483698'

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true), channel (object), already_in_channel (boolean). On error, contains: ok (boolean - false), error (string).
• OriginalStatusCode (number): The original HTTP status code returned by the Slack API. Default 0 means the request did not reach upstream (e.g., timeout). Use for debugging.
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Kick a User from a Channel

Remove a user from a Slack channel by ID. Requires channels:manage or groups:write (or equivalent) on the Slack app.

Input Parameters:

• ChannelId: The unique identifier of the Slack channel (e.g., C1234567890). Obtain via Get Many Channels or Get a Channel. Example: "C1234567890"
• UserId: The unique identifier of the user to remove (e.g., U9876543210). Obtain via Get Many Users or Get Information about a User. Example: "U9876543210"

Output:

• Result (object): Complete Slack API response object (pass-through). Success: {"ok": true}. Failure: {"ok": false, "error": "..."}.
• OriginalStatusCode (number): The original HTTP status code returned by Slack API. 0 means the request did not reach Slack (e.g., timeout).
• StatusCode (number): Operation status code: 200=Success (check ErrorMessage for business errors), -1=Parameter validation error, 500=System error (may retry).
• ErrorMessage (string): Detailed error message if any error occurred. Empty string if the operation succeeded.

Get Many Files

Get files from a Slack workspace with pagination support. Supports filtering by channel and user. Returns complete Slack file objects and pagination metadata. To get all files, loop until Pagination.has_more is false, passing Pagination.next_cursor as Cursor in each subsequent request.

Options:

• ChannelId: Slack channel's unique identifier (the 'id' field) to filter files by channel. Format: 11-character code starting with 'C' (public) or 'G' (private), e.g., 'C024BE91L'. Do NOT pass channel names like '#general'. Leave empty to return files from all channels. Example: 'C024BE91L'
• UserId: Slack user's unique identifier (the 'id' field) to filter files uploaded by a specific user. Format: 11-character code starting with 'U' (regular user) or 'W' (Enterprise Grid user), e.g., 'U024BE7LH'. Do NOT pass usernames or @display_names. Leave empty to return files from all users. Example: 'U024BE7LH'
• Count: Maximum number of files to return per page (1-1000). Default: 100. Use with Cursor parameter for pagination. Recommended: 50 (fast) or 200 (regular). Example: 50
• Cursor: Pagination cursor from previous response's NextCursor field. Leave empty for first page. Obtain from previous response to fetch next batch. Example: "dXNlcjpVMDYxTkZUVDI="

Output:

• Files (object-array): Array of complete Slack file objects (pass-through from API). Each file object contains all fields returned by Slack API, including id, name, title, mimetype, filetype, user, created, size, url_private, permalink, etc.
• Pagination (object): Pagination metadata object containing: next_cursor (string), has_more (boolean).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API. 0 means request did not reach Slack (e.g., timeout). Use for debugging.
• StatusCode (number): Business status code: 200=Success, 500=System Error, -1=Parameter Error.
• ErrorMessage (string): Error description. Empty if successful.

Get a File

Retrieve metadata for a single Slack file (name, size, mimetype, download URLs, uploader). Returns the complete file object. Limitations: Metadata only, not binary content. Requires files:read scope.

Input Parameters:

• FileId: Slack file's unique identifier (the 'id' field). Format: a code starting with 'F' followed by alphanumeric characters, e.g., 'F07EXAMPLE123'. Do NOT pass file names or URLs. Example: 'F07EXAMPLE123'

Output:

• FileInfo (object): The complete file object returned by the Slack API. Key fields: 'id' (string); 'name' (string); 'title' (string); 'mimetype' / 'filetype' / 'pretty_type' (strings); 'size' (number); 'url_private' (string); 'url_private_download' (string); 'permalink' (string); 'user' (string); 'channels' / 'groups' / 'ims' (arrays of strings).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200 for success, 404 for not found).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Delete a Message

⚠️ WARNING: Permanently delete a Slack message by channel ID and timestamp. This action CANNOT be undone. The message will be removed from all users' view immediately. Returns the complete Slack API response.

Input Parameters:

• ChannelId: The channel ID containing the message to delete. Obtain from Get Many Channels, Get a Channel, or Get the History of a Channel. Format: starts with 'C' (or 'G' / 'D' for other conversation types) followed by alphanumeric characters. Example: 'C01234ABCDE'
• Ts: Slack's unique identifier for the target message to delete (the 'ts' field). Although formatted as a Unix timestamp with microseconds (e.g., '1609459200.123456'), it must be an exact value — do not construct or approximate it manually. This action also accepts 16-digit ('1609459200123456') numeric format and will auto-convert. Example: '1609459200.123456'

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true), channel (string - channel ID), ts (string - message timestamp). On error, contains: ok (boolean - false), error (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 429).
• StatusCode (number): System status code. 200 for successful execution (even if business logic failed), 500 for system errors.
• ErrorMessage (string): Detailed error message if the deletion failed. Empty on success.

Get Thread Messages

Product label: The picker may list this as Get a Thread of Messages Posted to a Channel; behavior and parameters are as documented here.

Retrieve replies in a Slack thread. For general channel history, use 'Get the History of a Channel' instead. Returns message objects (each 'ts' reusable downstream) and pagination metadata. Limitations: Replies[0] is the parent itself.

Input Parameters:

• Channel: The ID of the channel containing the thread. Format: C1234567890. Obtain from 'List Channels' action or Slack URL. Example: C1234567890
• Ts: Slack's unique identifier for the PARENT message that started the thread (the 'ts' field). Although formatted as a Unix timestamp with microseconds (e.g., '1503435956.000247'), it must be an exact value — do not construct or approximate it manually. IMPORTANT: Do NOT pass a reply's 'ts' here — if a message has a 'thread_ts' field, that 'thread_ts' value (not its own 'ts') is the parent identifier you should use. Example: '1503435956.000247'

Options:

• Limit: The maximum number of items to return (max 1000). Default is 100. Example: 100
• Cursor: Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request's response_metadata. Example: dXNlcjpVMDYxTkZUVDI=

Output:

• Replies (object-array): Array of message objects in the thread. IMPORTANT: Replies[0] is the PARENT message itself (its 'ts' equals the input Ts); Replies[1..] are the actual replies. Key fields per object: 'text' (string); 'user' (string); 'ts' (string); 'thread_ts' (string); 'reactions' (array).
• Pagination (object): Pagination metadata. Contains: has_more (boolean) indicating if more messages exist, and next_cursor (string) to be used in the next request.
• OriginalStatusCode (number): The original HTTP status code returned by the Slack API. Default is 0 if request failed to reach upstream.
• StatusCode (number): An HTTP status code indicating the success or failure of the API request.
• ErrorMessage (string): A descriptive error message explaining why the request failed.

Get a Message Permalink

Get a permanent shareable link for a specific Slack message. Useful for sharing message references, creating documentation links, or building audit trails. Returns the complete Slack API response with the 'permalink' string.

Input Parameters:

• ChannelId: The Slack channel ID where the message is located. Format: starts with 'C' followed by 10 alphanumeric characters (e.g., C1234567890). Example: "C1234567890"
• MessageTs: Slack's unique identifier for the target message (the 'ts' field). Although formatted as a Unix timestamp with microseconds (e.g., '1754964154.670459'), it must be an exact value — do not construct or approximate it manually. This action also accepts 16-digit ('1754964154670459') numeric format and will auto-convert. Example: '1754964154.670459'

Output:

• MessageLink (object): The complete response object returned by Slack API. Key fields: ok (boolean), permalink (string), channel (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 404).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Get the History of a Channel

Retrieves the chat records (message history) from a specific Slack channel. Use this to fetch past messages, support pagination and time-range filtering. Returns the complete Slack API response. Limitations: Rate limits apply. History visibility depends on token permissions.

Input Parameters:

• ChannelId: The unique identifier of the Slack channel (e.g., C0123456789). Example: "C0123456789"

Options:

• Limit: The maximum number of messages to return in a single request. Range: 1-1000. Default: 100. Example: 100
• Cursor: Pagination parameter used to retrieve the next page of results. Use the 'NextCursor' value from a previous response. Example: "dXNlcjpVMDYxTkZUVDI="
• Oldest: Time-range filter: only messages POSTED AFTER this Unix timestamp are returned. This IS a real wall-clock time. NOTE: This is a time filter, NOT a message identifier. Example: '1704067200'
• Latest: Time-range filter: only messages POSTED BEFORE this Unix timestamp are returned. This IS a real wall-clock time. NOTE: This is a time filter, NOT a message identifier. Example: '1704153600'

Output:

• Result (object): The complete Slack API response object (pass-through). Key fields on success: 'ok' (bool) — true; 'messages' (array) — message objects, where each message has: 'text' (string); 'user' (string); 'ts' (string); 'thread_ts' (string); 'reactions' (array); 'has_more' (bool); 'response_metadata.next_cursor' (string).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200 for success, 429 for rate limit).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Send Message and Wait

Product label: The picker may list this as Send a Message and Wait Response; behavior and parameters are as documented here.

Send a Slack message and wait for a reply. Use for interactive flows (approval, Q&A); for plain notifications use 'Send a Message'. Returns the reply and the prompt we sent. Limitations: Blocks until reply or timeout. Poll interval: 5s. StatusCode 500 on timeout.

Input Parameters:

• ChannelId: Slack channel unique identifier (Channel ID), format is an 11-character string starting with C (e.g., C1234567890). Example: "C1234567890"
• Text: The message text to send.

Options:

• Timeout: Maximum seconds to wait for a reply (default 60). The system polls every 5 seconds. If timeout occurs, returns StatusCode 500. Recommended: 30-300. Example: 60

Output:

• ReplyMessage (object): The complete reply message object (pass-through). Empty object if timeout occurs. Key fields: 'type' (string); 'text' (string); 'user' (string); 'ts' (string); 'thread_ts' (string); 'reactions' (array).
• SentMessage (object): The complete Slack API response object for the message we sent (pass-through, from chat.postMessage). Key fields: 'ok' (bool); 'channel' (string); 'ts' (string); 'message' (object).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API.
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error (including timeout), -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful. Contains 'Timeout waiting for reply.' if no reply received within timeout period.

Send a Message

Send a message to a Slack channel. Use to notify teams, post updates, or reply to threads. Returns the Slack API response. Message.ts is the sent message's unique ID, reusable in other message-targeting actions.

Input Parameters:

• Channel: The ID of the channel where the message will be sent (e.g., 'C12345678'). Required for identifying the destination.
• Text: The message text. Required unless blocks are provided. Example: "Hello, world!"

Options:

• ThreadTs: Slack's unique identifier of the PARENT message to reply to (the 'ts' field). Although formatted as a Unix timestamp with microseconds, it must be an exact value — do not construct or approximate it manually. Leave empty for a top-level message. Example: '1234567890.123456'
• Blocks: A JSON-based array of structured blocks for rich message layout. See Slack Block Kit documentation for details. Example: [{"type": "section", "text": {"type": "mrkdwn", "text": "Hello!"}}]

Output:

• Message (object): The complete Slack API response object (pass-through). Key fields on success: 'ok' (bool) — true; 'channel' (string) — channel ID where the message was posted; 'ts' (string) — Slack's unique identifier for the sent message; 'message' (object) — full message details.
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 400, 404).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Update a Message

Change the text of an existing Slack message (chat.update).

Credentials (GoInsight): The Slack integration only receives a Bot User OAuth Token (xoxb-) from the service side. A User OAuth Token (xoxp-) is not something you can add or switch to in the product — plan around bot token only.

What works with xoxb-: Slack allows a bot to update messages that the same bot posted (subject to scopes such as chat:write). Use Send a Message (or the returned ts) and then this action on that bot-owned message.

What does not: Editing other users’ messages, or older content your token did not author, typically needs a user token and user OAuth scopes that this deployment does not expose. Do not expect “edit any message in the channel” behavior with the credentials you are given.

Returns the Slack API response as for other actions.

Input Parameters:

• ChannelId: The unique ID of the channel (e.g., 'C1234567890'). Obtain via 'Get Many Channels' or channel details in Slack.
• Ts: Slack's unique identifier for the target message to update (the 'ts' field). Although formatted as a Unix timestamp with microseconds (e.g., '1712345678.123456'), it must be an exact value — do not construct or approximate it manually. This action also accepts 16-digit ('1712345678123456') numeric format and will auto-convert. Example: '1712345678.123456'
• Text: The new text content for the message. Supports Slack mrkdwn formatting.

Output:

• Result (object): The complete Slack API response object (pass-through). Key fields on success: 'ok' (bool) — true; 'channel' (string) — channel ID where the message lives; 'ts' (string) — Slack's unique identifier for this message; 'text' (string) — updated message text; 'message' (object) — full message details.
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 400, 404).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Detailed error description. Empty string if successful.

Add a Reaction

Add an emoji reaction to a specific message in a Slack channel. Use this to acknowledge messages, vote, or trigger workflows. Returns the complete Slack API response. Limitations: Cannot react to messages that are too old.

Input Parameters:

• Channel: The ID of the channel containing the message. Format: 11-character string starting with 'C' (public), 'G' (private/group), or 'D' (DM). Example: 'C1234567890'.
• Name: The emoji name to add as a reaction. Format: Plain emoji name without colons (e.g., 'thumbsup', not ':thumbsup:'). Example: 'thumbsup'
• Timestamp: Slack's unique identifier for the target message (the 'ts' field). Although formatted as a Unix timestamp with microseconds (e.g., '1754964154.670459'), it must be an exact value — do not construct or approximate it manually. This action also accepts 16-digit ('1754964154670459') or 13-digit ('1754964154670') numeric formats and will auto-convert. Example: '1754964154.670459'

Output:

• Result (object): The complete Slack API response object (pass-through). On success, contains: ok (boolean - true if successful). On error, contains: ok (boolean - false), error (string - error code like 'already_reacted', 'message_not_found', 'no_permission').
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API.
• StatusCode (number): Operation status code: 200 for success; -1 for client-side validation errors; 500 for API errors or permission issues.
• ErrorMessage (string): Detailed error message. Common Slack errors: 'already_reacted', 'message_not_found', 'no_permission'. Empty if successful.

Get a Reaction

Retrieves all reactions (emoji responses) attached to a specific Slack message. Requires channel ID and message timestamp as identifiers. Returns the complete Slack API response object (pass-through), including the message object with its reactions array, type, channel, and other metadata. Supports automatic timestamp normalization for 13/16-digit Unix timestamps. Useful for analyzing message engagement, tracking team sentiment, or building custom analytics dashboards.

Input Parameters:

• ChannelId: The Slack channel ID where the target message is located. Format: 11-character string starting with 'C' (public), 'G' (private/group), or 'D' (DM), e.g., 'C1234567890'. Example: 'C1234567890'
• Timestamp: Slack's unique identifier for the target message (the 'ts' field). Although formatted as a Unix timestamp with microseconds (e.g., '1754964154.670459'), it must be an exact value — do not construct or approximate it manually. This action also accepts 13/16-digit numeric formats and will auto-convert. Example: '1754964154.670459'

Output:

• Reactions (object): The complete response object returned by Slack API (pass-through). Key fields: ok (boolean), message (object), message.reactions (array), type (string), channel (string).
• OriginalStatusCode (number): The original HTTP status code returned by the Slack API. Default 0 means the request did not reach Slack (e.g., timeout). Use for debugging.
• StatusCode (number): Operation status code: 200=Success (check ErrorMessage for business errors), -1=Parameter validation error, 500=System error (may retry).
• ErrorMessage (string): Detailed error message if any error occurred. Empty string if the operation succeeded.

Remove a Reaction

Remove a reaction from a Slack message by timestamp. The action returns the complete Slack API response object. Supports auto-format for 13/16-digit timestamps. ⚠️ Operation is reversible - users can re-add reactions.

Input Parameters:

• ChannelId: The channel ID containing the message. Format: Starts with 'C' followed by alphanumeric characters (e.g., 'C01234ABCDE'). Example: "C01234ABCDE"
• Name: The name of the reaction (emoji) to remove. Use the emoji shortcode without colons (e.g., 'thumbsup', 'heart', 'fire'). Do NOT use Unicode emoji or colon-wrapped format. Example: "thumbsup"
• Timestamp: Slack's unique identifier for the target message (the 'ts' field). Although formatted as a Unix timestamp with microseconds (e.g., '1735977600.123456'), it must be an exact value — do not construct or approximate it manually. This action also accepts 13/16-digit numeric formats and will auto-convert. Example: '1735977600.123456'

Output:

• Result (object): Complete Slack API response object (pass-through). Success: {"ok": true}. Failure: {"ok": false, "error": "..."}. Requires reactions:write scope.
• OriginalStatusCode (number): The original HTTP status code returned by the Slack API (e.g., 200, 400, 404).
• StatusCode (number): The business status code. 200 for success, -1 for parameter errors, 500 for system/network errors.
• ErrorMessage (string): Detailed error message if the operation failed. Empty on success.

Get Information about a User

Product label: This action may appear in the UI as Get Infomation about a User (typo); behavior and parameters are as documented here.

Get detailed info about a Slack user (profile, email, real_name, etc.). Not for searching users. Returns the complete Slack user object. User.id is reusable in other user-targeting actions.

Input Parameters:

• UserId: Slack user's unique identifier (the 'id' field). Format: 11-character code starting with 'U' (regular user) or 'W' (Enterprise Grid user), e.g., 'U1234567890'. Although it looks like a short code, it must be an exact value — do not construct or guess it, and do NOT pass usernames or @display_names. Example: 'U1234567890'

Output:

• User (object): The complete user object returned by the Slack API. Key fields: 'id' (string) — Slack's unique user identifier; 'name' (string) — username/handle; 'real_name' (string) — full real name; 'team_id' (string) — workspace ID; 'profile' (object); 'is_admin' (bool); 'is_bot' (bool); 'deleted' (bool); 'tz' (string); 'updated' (number).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 404).
• StatusCode (number): System operation status code. 200 = system healthy, 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): Error description. Empty string if successful.

Get Many Users

List users in a Slack workspace, one page per request. Returns complete user objects and pagination metadata. Each Users[].id is reusable as UserId in other user-targeting actions. Loop until Pagination.has_more is false, passing Pagination.next_cursor as Cursor.

Options:

• Limit: Maximum number of users to return per page. Default: 100. Use with Cursor parameter to paginate through large user lists. For workspaces with <500 users, use default 100. For >1000 users, consider 200-500 for efficiency. Example: 100
• Cursor: Pagination cursor for fetching the next page of results. Leave empty for the first request. Use the 'next_cursor' value from Pagination in the previous response to get the next page. Example: "dXNlcjpVMDYxTkZUVDI="
• IncludeDeleted: Whether to include deleted user accounts in the results. Leave empty or set to false (default) to only see active members. Set to true to include both active and deleted users.

Output:

• Users (object-array): List of users in the Slack workspace. Each user object contains core fields like id, name, real_name, display_name, email, title, phone, is_admin, is_owner, is_bot, status, status_emoji, avatar, deleted.
• Pagination (object): Pagination metadata object containing: returned_count (number), next_cursor (string), has_more (boolean).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200 for success, 429 for rate limit).
• StatusCode (number): An HTTP status code indicating the success or failure of the API request (200 for success, 500 for system error).
• ErrorMessage (string): A descriptive error message explaining why the request failed. Empty on success.

Get a User Presence Status

Get a user's online status in Slack (active/away). Use this to check availability before sending messages or scheduling meetings. Returns the complete Slack API response with the 'presence' field ('active' = online, 'away' = away/inactive).

Input Parameters:

• UserId: Slack user's unique identifier (the 'id' field) of the user whose presence you want. Format: 11-character code starting with 'U' (regular user) or 'W' (Enterprise Grid user), e.g., 'U1234567890'. Do NOT pass usernames or @display_names. Example: 'U1234567890'

Output:

• Presence (object): The complete response object returned by Slack API (pass-through). Key fields: ok (boolean), presence (string), online (boolean), auto_away (boolean), manual_away (boolean), connection_count (number), last_activity (timestamp).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200, 400, 429).
• StatusCode (number): The system status code. 200 indicates the request was processed successfully (even if a business error occurred).
• ErrorMessage (string): Detailed error description if the request failed or Slack returned an error (e.g., 'user_not_found').

Get a User Profile

Get a Slack user profile (email, phone, real_name, display_name, title, status, avatars). Returns the complete profile object. Limitations: Some fields (like email) may be hidden by workspace privacy settings. For overlapping fields, compare with Get Information about a User.

Options:

• UserId: Slack user's unique identifier (the 'id' field) of the user whose profile you want. Format: 11-character code starting with 'U' (regular user) or 'W' (Enterprise Grid user), e.g., 'U1234567890'. Do NOT pass usernames or @display_names. Leave EMPTY to retrieve the profile of the currently authenticated user (token owner) — useful for self-introspection. Example: 'U1234567890'

Output:

• Profile (object): The complete response object returned by Slack API (pass-through). Key fields: ok (boolean), profile (object containing real_name, display_name, email, phone, title, status_text, status_emoji, image_*, first_name, last_name, skype, team).
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API (e.g., 200 for success, 404 for not found).
• StatusCode (number): System operation status code. 200 = system healthy (including API business errors), 500 = system error, -1 = parameter validation error.
• ErrorMessage (string): A descriptive error message explaining why the request failed. Empty string if successful.

Get Many User Groups

Get all user groups in a Slack workspace. Note: The Slack API returns all user groups in a single request; it does not support server-side pagination or cursors. This action returns the complete list of groups available to the authenticated user.

Options:

• IncludeUsers: Whether to include the 'users' array (list of Slack user IDs) for each User Group. Set to true if you need to inspect group membership. Default is false.

Output:

• Usergroups (object-array): Array of user group (usergroup) objects. Key fields per object: 'id' (string, e.g., 'S0614TZR7') — Slack's unique usergroup identifier; 'name' (string) — display name; 'handle' (string, e.g., 'marketing-team') — the @mention handle; 'description' (string); 'user_count' (number); 'users' (array of strings) — Slack user IDs of group members, only populated if IncludeUsers=true; 'date_create' (number, Unix timestamp).
• Pagination (object): Information about the returned data set. Note: Since Slack API returns all groups at once, has_more will always be false.
• OriginalStatusCode (number): The raw HTTP status code returned by the Slack API.
• StatusCode (number): The system status code. 200 for success, 500 for network/timeout errors, -1 for validation errors.
• ErrorMessage (string): Detailed error message if the request failed.