Skip to main content
Slackbot logo
  • Category: team chat
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 104
  • Triggers: 9
  • Slug: SLACKBOT
  • Version: 20261101_00

Frequently Asked Questions

For Slackbot triggers with custom auth, put the Slack app verification token in the Slackbot auth config, then create a fresh connection.
If Slack token rotation is enabled on the Slack app, repeated connections for the same user/app can invalidate older tokens. Slack documents a two-active-token limit for token rotation: when more than two active tokens exist after a refresh, Slack revokes the oldest extra token.This can look like older Slackbot connections expiring after a third connection or after another connection refreshes. Avoid creating multiple active Slackbot connections for the same Slack user and OAuth app unless the product is designed to handle older connections expiring. See Slack’s token rotation documentation.

Tools

Slug: SLACKBOT_ADD_CALL_PARTICIPANTSRegisters new participants added to a Slack call.

Input Parameters

string
required
ID of the call returned by the add method.
string
required
The list of users to add as participants in the call. users is a JSON array (formatted as a string) containing information for each user. Each element must include a slack_id. For example: [{"slack_id": "U1H77"}] or [{"slack_id": "U1H77"}, {"slack_id": "U2ABC123"}].

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_ADD_REACTION_TO_AN_ITEMAdds a specified emoji reaction to a Slack message identified by channel and timestamp. An already-existing reaction is reported as success.

Input Parameters

string
required
Name of the emoji to add as a reaction (e.g., ‘thumbsup’). This is the emoji name without colons. For emojis with skin tone modifiers, append ‘::skin-tone-X’ where X is a number from 2 to 6 (e.g., ‘wave::skin-tone-3’). The emoji must already exist in the workspace; custom or non-existent emoji names will fail silently.
string
required
ID of the channel where the message to add the reaction to was posted.
string
required
Timestamp of the message to which the reaction will be added. This is a unique identifier for the message, typically a string representing a float value like ‘1234567890.123456’. Must be the exact message timestamp; permalinks or approximate values will not work.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_ADD_REMOTE_FILEAdds a reference to an external file (e.g., Google Drive, Dropbox) to Slack for discovery and sharing, requiring a unique external_id and an external_url accessible by Slack.

Input Parameters

string
required
Title of the remote file to be displayed in Slack.
string
File type (e.g., ‘pdf’, ‘docx’, ‘png’) to help Slack display appropriate icons or previews.
string
required
Unique identifier for the file, defined by the calling application, used for future API references (e.g., updating, deleting).
string
required
Publicly accessible or permissioned URL of the remote file, used by Slack to access its content or metadata.
string
Base64-encoded image (e.g., PNG, JPEG) used as the file’s preview in Slack.
string
Plain text content of the file, indexed by Slack for search.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_ARCHIVE_CONVERSATIONArchives a Slack conversation by its ID, rendering it read-only and hidden while retaining history, ideal for cleaning up inactive channels; be aware that some channels (like #general or certain DMs) cannot be archived and this may impact connected integrations.

Input Parameters

string
ID of the Slack conversation to archive. This ID uniquely identifies a channel (e.g., public, private).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CLOSE_DMCloses a Slack direct message (DM) or multi-person direct message (MPDM) channel, removing it from the user’s sidebar without deleting history; this action affects only the calling user’s view.

Input Parameters

string
required
The ID of the direct message or multi-person direct message channel to close. Example: D1234567890 or G0123456789.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_COMPLETE_EXTERNAL_FILE_UPLOADFinalize uploaded file IDs once and optionally share the files.

Input Parameters

array
required
One or more reserved Slack file IDs with optional titles.
array
Block Kit blocks for the file-share message; serialized for Slack, which ignores them when initial_comment is set.
string
Comma-separated channel or user IDs where the files will be shared, up to 100 destinations.
string
Parent message timestamp when sharing the files as a thread reply.
string
Channel where the completed files will be shared; omit to keep them private.
string
Comment introducing the shared files.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CREATE_A_REMINDERCreates a Slack reminder with specified text and time; time accepts Unix timestamps, seconds from now, or natural language (e.g., ‘in 15 minutes’, ‘every Thursday at 2pm’).

Input Parameters

string
required
The textual content of the reminder message.
string
required
Specifies when the reminder should occur. This can be a Unix timestamp (integer, up to five years from now), the number of seconds until the reminder (integer, if within 24 hours, e.g., ‘300’ for 5 minutes), or a natural language description (string, e.g., “in 15 minutes,” or “every Thursday at 2pm”, “daily”). For recurring reminders, express the recurrence in this field using natural language (e.g., ‘every day at 9am’, ‘every Monday at 10am’). Natural language is parsed relative to the user’s workspace timezone; use Unix timestamps when target timezone is uncertain.
string
The ID of the user who will receive the reminder (e.g., ‘U012AB3CD4E’). If not specified, the reminder will be sent to the user who created it. NOTE: Setting reminders for other users is no longer supported for user tokens - only bot tokens can set reminders for other users.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CREATE_CANVASCreates a new Slack Canvas with the specified title and optional content.

Input Parameters

string
The title of the canvas to create. If not provided, Slack will generate a default title.
string
Optional channel ID (e.g., ‘C1234567890’). If provided, the canvas will be automatically added as a tab in this channel with write permissions.
object
Optional canvas content in Slack’s document format. If not provided, creates an empty canvas.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CREATE_CHANNELInitiates a public or private channel-based conversation in a Slack workspace. Immediately creates the channel; invoke only after explicit user confirmation.

Input Parameters

string
required
Name of the public or private channel to create Must be lowercase, unique, and contain no spaces or periods; max 80 characters.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
boolean
Create a private channel instead of a public one

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CREATE_LISTCreates a new Slack List via slackLists.create. Provide a name and, optionally, a description_blocks description and a schema of typed columns. You can instead copy an existing List’s structure with copy_from_list_id (and its rows via include_copied_list_records), or enable task-tracking columns with todo_mode. Returns the new List’s list_id. Requires a user token with the lists:write scope.

Input Parameters

string
required
The name (title) of the Slack List to create, e.g. ‘Sprint Tasks’. This is shown as the List’s title in Slack and is required.
array
Column definitions for the List. Each entry is a column object describing a typed column (its name, type, and any type-specific options such as select choices). Supported column types include text, select, user, date, number, checkbox, and others. Omit to create a List with Slack’s default columns.
boolean
Set to true to create the List in to-do mode, which adds Slack’s built-in task-tracking columns (such as assignee, due date, and completion status) so the List behaves as a task tracker.
string
ID of an existing Slack List to copy the structure from, e.g. ‘F0123456789’. When provided, the new List is created with the same columns as that List. Use include_copied_list_records to also copy its rows.
string
Rich text describing the List, shown beneath the title. Slack stores this as Block Kit rich_text blocks. For convenience you may pass a plain string (it is wrapped into a rich_text block automatically), a single block dict (wrapped in a list), or an already-formed list of blocks (passed through unchanged). Omit to create a List with no description.
boolean
When copying from another List via copy_from_list_id, set to true to also copy that List’s existing items (rows) into the new List. Has no effect unless copy_from_list_id is set.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CREATE_LIST_ITEMCreates a new item (row) in a Slack List via slackLists.items.create. Set initial cell values with initial_fields; text columns require Block Kit rich_text (a plain string is wrapped automatically). Optionally duplicate an existing row with duplicated_item_id or create a subtask with parent_item_id. Requires a user token with the lists:write scope.

Input Parameters

string
required
ID of the Slack List to add the item (row) to, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list.
array
Initial cell values for the new row. Each entry is a cell object with a column_id and a typed value. Text columns must use Block Kit rich_text (the plain text property is not accepted on input) — for convenience a cell may instead supply a plain string text and it will be wrapped into a rich_text block automatically. Other column types use their typed key, e.g. select, user, date, number, checkbox. For select, pass an array of the column’s choice VALUES (e.g. ["todo"]) — Slack does not mint separate per-option IDs. Omit to create an empty row.
string
ID of an existing item (row) to attach the new row to as a subtask. When provided, the new row is created as a sub-item of that parent.
string
ID of an existing item (row) in this List to copy. When provided, the new row is created as a duplicate of that item; initial_fields may still be supplied to override copied values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CREATE_USER_GROUPCreates a new User Group (often referred to as a subteam) in a Slack workspace.

Input Parameters

string
required
Unique name for the User Group. Must be unique among all User Groups in the workspace.
string
Unique mention handle. Must be unique across channels, users, and other User Groups. Max 21 chars; lowercase letters, numbers, hyphens, underscores only.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
Comma-separated encoded channel IDs for default channels, suggested when mentioning or inviting the group.
string
Short description for the User Group.
boolean
Include the User Group’s user count in the response. Server defaults to false if omitted.
boolean
Configure this user group to show as a sidebar section for all group members. Only relevant if group has 1 or more default channels added.
string
Comma-separated encoded channel IDs for which the User Group can custom add usergroup members to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_CUSTOMIZE_URL_UNFURLCustomizes URL unfurls in a posted Slack message or message composer using custom preview content or Work Object metadata. It can also provide authentication prompts for unfurling.

Input Parameters

string
Timestamp of the message to customize URL unfurling for. Must be provided with channel, or alternatively provide unfurl_id and source together.
string
Link source: either ‘composer’ or ‘conversations_history’. Must be provided with unfurl_id.
string
Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. Must be provided with ts, or alternatively provide unfurl_id and source together.
string
JSON string mapping URLs to custom unfurl content (Slack attachment format or blocks). Pass as a plain JSON string (not URL-encoded). To remove an existing unfurl, provide an empty object for that URL.
string
JSON object with ‘entities’ field providing Work Object array. Either unfurls or metadata is required. Pass as a JSON string.
string
Link ID to unfurl. Must be provided with source. Alternative to using channel and ts parameters.
string
URL-encoded custom URL for user authentication with your app to enable unfurling. Used when user_auth_required is true.
string
JSON array of structured blocks (URL-encoded) sent as ephemeral authentication invitation. Alternative to user_auth_message for richer formatting. Used when user_auth_required is true.
string
Ephemeral message text prompting user authentication with your app for domain-specific unfurling. Used when user_auth_required is true and authorization is pending.
boolean
Set to true if user authentication is required to unfurl links for a domain, enabling an authentication flow using user_auth_url and user_auth_message.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_CANVASDeletes a Slack Canvas permanently and irreversibly; always confirm with the user before calling. For skill canvases, Slack may return success without deleting the canvas and indicate that the Skills API is required.

Input Parameters

string
required
The unique identifier of the canvas to delete

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_FILEPermanently deletes an existing file from a Slack workspace using its unique file ID; this action is irreversible and also removes any associated comments or shares.

Input Parameters

string
required
ID of the file to delete. Typically obtained when a file is uploaded or listed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_FILE_COMMENTDeletes a specific comment from a file in Slack; this action is irreversible.

Input Parameters

string
required
ID of the comment to delete. This can be obtained when the comment is created or by listing file comments.
string
required
ID of the file to delete a comment from. The file ID can be obtained using the files.info method or when a file is shared.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_LIST_ACCESSRevokes sharing access on a Slack List via slackLists.access.delete. Provide the list_id and EXACTLY ONE of channel_ids or user_ids (they are mutually exclusive) to remove access for those channels or users. Requires a user token with the lists:write scope.

Input Parameters

string
required
ID of the Slack List to revoke sharing access on, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list.
array
IDs of the users to revoke access from, e.g. [‘U0123456789’]. Mutually exclusive with channel_ids: provide EXACTLY ONE of user_ids or channel_ids. Supplying both, or neither, causes the API to return an invalid_parameters error.
array
IDs of the channels to revoke access from, e.g. [‘C0123456789’]. Mutually exclusive with user_ids: provide EXACTLY ONE of channel_ids or user_ids. Supplying both, or neither, causes the API to return an invalid_parameters error.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_LIST_ITEMDeletes an item (row) from a Slack List via slackLists.items.delete. Identify the List with list_id and the row to remove with id. Deletion is permanent and cannot be undone. Requires a user token with the lists:write scope.

Input Parameters

string
required
ID of the item (row) to delete from the List, e.g. ‘Rec0123456789’. This is the item ID returned by create_slack_list_item or when listing the List’s items. Deleting an item is permanent and cannot be undone.
string
required
ID of the Slack List that contains the item (row) to delete, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_MULTIPLE_LIST_ITEMSDeletes several items (rows) from a Slack List in one call via slackLists.items.deleteMultiple. This operation is ALL-OR-NOTHING: Slack returns a single {"ok": true} on success or {"ok": false, "error": ...} on failure, with NO per-item result array, so partial state cannot be reported. On failure, treat the whole batch as not deleted and retry the entire batch. Requires a user token with the lists:write scope.

Input Parameters

array
required
Array of item (row) IDs to delete from the List in a single call, e.g. [‘Rec0123456789’, ‘Rec9876543210’]. IMPORTANT: this operation is ALL-OR-NOTHING. Slack slackLists.items.deleteMultiple returns a single {"ok": true} on success or {"ok": false, "error": ...} on failure, with NO per-item result array — so partial state cannot be reported. If the call fails, treat the entire batch as not deleted and retry the whole batch (do not assume some rows were removed).
string
required
ID of the Slack List to delete items (rows) from, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list. All of the ids must belong to this List.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_REMINDERDeletes an existing Slack reminder, typically when it is no longer relevant or a task is completed; this operation is irreversible.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
required
The unique identifier of the reminder to be deleted. This ID is obtained when a reminder is created or listed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETES_A_MESSAGE_FROM_A_CHATDeletes a message, identified by its channel ID and timestamp, from a Slack channel, private group, or direct message conversation; the authenticated user or bot must be the original poster.

Input Parameters

string
Timestamp of the message to be deleted. Must be the exact Slack message timestamp string with fractional precision, e.g., ‘1234567890.123456’. Thread replies use their own ts; ephemeral messages and certain app-posted messages cannot be deleted via this method even with a valid timestamp.
boolean
Legacy parameter for classic Slack apps. Pass true to delete the message as the authed user. Bot tokens can only delete messages posted by that bot. This parameter is primarily for legacy apps and is generally not needed with modern bot tokens.
string
The ID of the channel, private group, or direct message conversation containing the message to be deleted.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DELETE_SCHEDULED_MESSAGEDeletes a pending, unsent scheduled message from the specified Slack channel, identified by its scheduled_message_id.

Input Parameters

boolean
Pass true to delete the message as the authed user with chat:write:user scope. Bot users in this context are considered authed users. If not provided, defaults to false.
string
required
ID of the channel, private group, or DM conversation where the message is scheduled.
string
required
Unique ID (scheduled_message_id) of the message to be deleted; obtained from chat.scheduleMessage response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DISABLE_USER_GROUPDisables a specified, currently enabled Slack User Group by its unique ID, effectively archiving it by setting its ‘date_delete’ timestamp; the group is not permanently deleted and can be re-enabled.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
required
Unique encoded ID of the User Group to disable.
boolean
If true, include the number of users in the User Group in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_DOWNLOAD_FILETool to download Slack file content and convert it to a publicly accessible URL. Use when you need to retrieve and download files that have been shared in Slack channels or conversations.

Input Parameters

string
required
ID of the file to download. This is a required field. File IDs start with ‘F’ followed by alphanumeric characters (e.g., ‘F123ABCDEF0’).
integer
Page number of comment results to retrieve. Used for comment pagination. Slack’s default is 1 if not provided. cursor-based pagination is generally preferred.
integer
Number of comments to retrieve per page. Used for comment pagination. Slack’s default is 100 if not provided.
integer
The maximum number of comments to retrieve. This is an upper limit, not a guarantee of how many will be returned. Primarily used for comment pagination.
string
Pagination cursor for retrieving comments. Set to next_cursor from a previous response’s response_metadata to fetch the next page of comments. Essential for navigating through large sets of comments.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_EDIT_CANVASEdits a Slack Canvas with granular control over content placement. Supports replace, insert (before/after/start/end) operations for flexible content management.

Input Parameters

string
required
The unique identifier of the canvas to edit
string ("replace" | "insert_after" | "insert_before" | "insert_at_start" | "insert_at_end" | "delete" | "rename")
Type of edit operation: ‘replace’ (replaces entire canvas or specific section if section_id provided), ‘insert_after’ (inserts content after section_id), ‘insert_before’ (inserts content before section_id), ‘insert_at_start’ (prepends content to beginning), ‘insert_at_end’ (appends content to end), ‘delete’ (deletes specific section by section_id), ‘rename’ (renames canvas title using title_content)
string
Section ID for targeted operations. Required for: ‘insert_after’, ‘insert_before’, ‘delete’. Optional for: ‘replace’ (if omitted, replaces entire canvas). Not used for: ‘insert_at_start’, ‘insert_at_end’. Use canvases.sections.lookup method to get section IDs from existing canvas.
object
The new title for the canvas in markdown format. Required only for ‘rename’ operation. Supports markdown format including emojis (e.g., ‘:white_check_mark:’).
object
The content to add/replace in Slack’s document format. Required for all operations except ‘delete’ and ‘rename’. Use canvases.sections.lookup to find section IDs for targeted operations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_ENABLE_PUBLIC_SHARING_OF_A_FILEEnables public sharing for an existing Slack file by generating a publicly accessible URL; this action does not create new files. Once enabled, the file is accessible to anyone with the URL — verify intent before sharing sensitive or confidential files.

Input Parameters

string
required
The ID of the file to be shared publicly.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_ENABLE_USER_GROUPEnables a disabled User Group in Slack using its ID, reactivating it for mentions and permissions; this action only changes the enabled status and cannot create new groups or modify other properties.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
required
The unique encoded ID of the User Group to enable. This ID typically starts with ‘S’.
boolean
If true, includes the count of users in the User Group in the response.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_END_CALLEnds an ongoing Slack call, identified by its ID (obtained from calls.add), optionally specifying the call’s duration.

Input Parameters

string
required
Unique identifier of the call to be ended, obtained from the calls.add method.
integer
Duration of the call in seconds.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_FETCH_CONVERSATION_HISTORYFetches a chronological list of messages and events from a specified Slack conversation, accessible by the authenticated user/bot, with options for pagination and time range filtering. IMPORTANT LIMITATION: This action only returns messages from the main channel timeline. Threaded replies are NOT returned by this endpoint. To retrieve threaded replies, use the SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION action (conversations.replies API) instead. The oldest/latest timestamp filters work reliably for filtering the main channel timeline, but cannot be used to retrieve individual threaded replies - even if you know the exact reply timestamp, setting oldest=latest to that timestamp will return an empty messages array. To get threaded replies: 1. Use this action to get parent messages (which include thread_ts, reply_count, latest_reply fields) 2. Use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION with the parent’s thread_ts to fetch all replies in that thread

Input Parameters

integer
Maximum number of messages to request in this single Slack API call (1-1000). Defaults to 100. Slack may return fewer than requested, especially for non-Marketplace apps where Slack can cap each page at 15 messages. This action does not internally paginate; use response_metadata.next_cursor in the cursor parameter of a follow-up call to fetch more messages.
string
Pagination cursor from response_metadata.next_cursor of a previous response. Omit this for the first page; pass the returned cursor in a follow-up call to fetch the next page.
string
End of the time range of messages to include in results. Accepts a Unix timestamp or a Slack timestamp (e.g., ‘1234567890.000000’). NOTE: This filter only applies to main channel messages, not threaded replies. Use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION to retrieve replies.
string
Start of the time range of messages to include in results. Accepts a Unix timestamp or a Slack timestamp (e.g., ‘1234567890.000000’). NOTE: This filter only applies to main channel messages, not threaded replies. Use SLACK_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION to retrieve replies.
string
required
The ID of the public channel, private channel, direct message, or multi-person direct message to fetch history from.
boolean
When true, includes messages at the exact ‘oldest’ or ‘latest’ boundary timestamps in results. When false (default), excludes boundary messages. Only applies when ‘oldest’ or ‘latest’ is specified.
boolean
Return all metadata associated with messages in the conversation history. When true, includes additional metadata fields that may be present on messages.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_FETCH_ITEM_REACTIONSFetches reactions for a Slack message, file, or file comment. Exactly one identifier path must be provided: channel+timestamp, file, or file_comment. Mixing identifiers (e.g., providing both channel+timestamp and file) causes errors. If the response omits the reactions field, the item has zero reactions.

Input Parameters

string
File ID. Use instead of channel/timestamp or file comment ID.
boolean
If true, returns the complete list of users for each reaction.
string
Channel ID. Required if timestamp is provided and no file or file comment ID is given.
string
Message timestamp (e.g., ‘1234567890.123456’). Required if channel is provided and no file or file comment ID is given. Thread reply timestamps are tracked separately from the parent message; use the reply’s own timestamp to fetch its reactions.
string
File comment ID. Use instead of channel/timestamp or file ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATIONRetrieves replies to a specific parent message in a Slack conversation, using the channel ID and the parent message’s timestamp (ts). Note: The parent message in the response contains metadata (reply_count, reply_users, latest_reply) that indicates expected thread activity. If the returned messages array contains fewer replies than reply_count indicates, check: (1) has_more=true means pagination is needed, (2) recently posted replies may have timing delays, (3) some replies may be filtered by permissions or deleted. The composio_execution_message field will warn about any detected mismatches.

Input Parameters

string
required
Timestamp of the parent message in the thread. Must be an existing message. If no replies, only the parent message itself is returned. Must be the exact full timestamp string of the root/parent message — not a reply’s ts, a truncated value, a permalink, or an integer; these silently return wrong results.
integer
Maximum number of messages to return. Fewer may be returned even if more are available.
string
Pagination cursor from response_metadata.next_cursor of a previous response to get subsequent pages. If omitted, fetches the first page.
string
Latest message timestamp in the time range to include results.
string
Oldest message timestamp in the time range to include results. Must be a UTC-based Slack ts string; incorrect timezone conversion or rounding can produce empty result windows.
string
required
ID of the conversation (channel, direct message, etc.) to fetch the thread from. Must be a channel ID, not a channel name. Token must have membership in private channels or DMs, otherwise returns empty results or not_in_channel/channel_not_found.
boolean
Whether to include messages with latest or oldest timestamps in results. Effective only if latest or oldest is specified.
boolean
Return all metadata associated with messages in the thread. When true, includes additional metadata fields that may be present on messages.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_FETCH_TEAM_INFOFetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible.

Input Parameters

string
The ID of the team to retrieve information for. If omitted, information for the current team (associated with the authentication token) is returned. The token must have permissions to view the specified team, especially for teams accessible via external shared channels.
string
Query by domain instead of team (only when team is null). This only works for domains in the same enterprise as the querying team token. This also expects the domain to belong to a team and not the enterprise itself.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_FIND_CHANNELSFinds Slack channels and conversations visible to the authenticated user by name, topic or purpose, with partial or exact matching. Searches one page at a time; results depend on conversation type, membership, archive settings and access, with a cursor to continue.

Input Parameters

integer
Maximum number of conversations to request from Slack in this single API page before local search filtering (1 to 999). Defaults to 50. Fewer matching channels may be returned; use response_metadata.next_cursor to search subsequent pages.
string
required
Search query to find channels. Searches across channel name, topic, purpose, and description (case-insensitive partial matching). Leading ’#’ prefix is automatically stripped.
string
Comma-separated list of channel types to include: public_channel, private_channel, mpim (multi-person direct message), im (direct message). Defaults to public and private channels.
string
Pagination cursor from response_metadata.next_cursor of a previous response. Omit for the first page.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
boolean
When true, only return channels whose name exactly matches the query (case-insensitive). Also matches against previous channel names and the ‘general’ flag. When false, returns partial matches across name, topic, and purpose. Defaults to false.
boolean
Only return channels the user is a member of. Defaults to false.
boolean
Exclude archived channels from search results. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_FIND_USER_BY_EMAIL_ADDRESSRetrieves the Slack user object for an active user by their registered email address; requires the users:read.email OAuth scope. Fails with ‘users_not_found’ if the email is unregistered, the user is inactive, the account is a guest, or the email is hidden by workspace privacy settings.

Input Parameters

string
required
The email address of the user to look up.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_FIND_USERSFind Slack users by ID, email, name, display name, or other text. General searches filter one page per call and return a cursor; direct ID and exact-email lookup failures may return empty results with a diagnostic message.

Input Parameters

string
Email address to search for. This is a convenience parameter that automatically performs an email-based search. Either email or search_query parameter is required.
integer
Maximum number of users to request from Slack in this single API page before local search filtering (1 to 1000). Defaults to 50. Fewer matching users may be returned; use response_metadata.next_cursor to search subsequent pages.
string
Pagination cursor from response_metadata.next_cursor of a previous users.list response. Used for general searches; omit for the first page.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
boolean
When true, only returns users with exact matches on name, display name, real name, first name, last name, or email fields (case-insensitive). For email queries, uses Slack’s dedicated email lookup endpoint. When false, allows partial/substring matching. Defaults to false.
boolean
Include bot users in search results. Defaults to false.
string
Search query to find users. Can be a Slack user ID (e.g., ‘U012ABCDEF’), email address, or name. For user IDs (starting with ‘U’ or ‘W’), uses Slack’s users.info API directly. For email addresses with exact_match=true, uses Slack’s email lookup endpoint. For other queries, searches across name, display name, real name, email, first name, last name, and status text (case-insensitive partial matching). Either search_query (or ‘query’ as alias), or email parameter is required. Name-based queries can return multiple matches — verify exactly one user ID before passing to downstream tools like SLACK_OPEN_DM or SLACK_SEND_MESSAGE; disambiguate using email or real_name fields.
boolean
Include the locale field for each user. Defaults to false.
boolean
Include deleted/deactivated users in search results. Defaults to false.
boolean
Include restricted (guest) users in search results. Defaults to true.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_BOT_USERFetches information for a specified, existing Slack bot user; will not work for regular user accounts or other integration types.

Input Parameters

string
The ID of the bot user to retrieve information for. This typically starts with ‘B’.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_CALL_INFORetrieves a point-in-time snapshot of a specific Slack call’s information.

Input Parameters

string
required
Unique identifier of the Slack call for which to retrieve information. This ID is typically returned when a call is initiated (e.g., by the calls.add method).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_CANVASRetrieves file metadata for a Slack Canvas by its ID. This action is deprecated and does not retrieve canvas document content.

Input Parameters

integer
Page number for comment pagination (1-based, max 100). Works with count parameter.
integer
Maximum number of comments to return per page (1-1000). Controls pagination of the comments field in the response.
integer
Maximum number of comments to return (alternative to count parameter). Recommended to use 200 or less for cursor-based pagination.
string
Cursor for pagination of comments. Use the next_cursor value from response_metadata to retrieve the next page. This is the preferred pagination method over page parameter.
string
required
The unique identifier of the canvas to retrieve The app must have access to the canvas; private or restricted canvases are not retrievable even with a valid ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_LIST_ITEMFetches a single item (row) from a Slack List via slackLists.items.info. Returns the row’s column_id-keyed typed values along with metadata about the parent List. Set include_is_subscribed to also report whether the calling user is subscribed to the row. Requires a user token with the lists:read scope.

Input Parameters

string
required
ID of the item (row) to fetch from the List, e.g. ‘Rec0123456789’. This is the id of a row previously returned by create_slack_list_item or a List-items listing call.
string
required
ID of the Slack List that contains the item (row) to fetch, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list.
boolean
When true, the returned row’s record includes an is_subscribed flag indicating whether the calling user is subscribed to that item. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_REMINDERRetrieves detailed information for an existing Slack reminder specified by its ID; this is a read-only operation.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
required
The unique identifier of the reminder to retrieve information for. This ID typically starts with ‘Rm’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_REMOTE_FILERetrieve information about a remote file added to Slack via the files.remote API. Does not work for standard Slack-hosted file uploads.

Input Parameters

string
Specify a file by providing its ID.
string
Creator defined GUID for the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_TEAM_PROFILERetrieves all profile field definitions for a Slack team, optionally filtered by visibility, to understand the team’s profile structure.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string ("all" | "visible" | "hidden")
Enum for visibility filter values.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_UNREAD_MESSAGES_FROM_USERRetrieves unread direct messages from a specified user in the authenticated user’s DM conversation, checking message history after the last-read timestamp. Opens or resumes the DM and returns matching messages oldest first, with a limit of 25 by default and up to 999.

Input Parameters

integer
Maximum number of unread messages to retrieve. Slack API allows up to 999, but defaults to 25 for token efficiency. Increase only when specifically needed.
string
required
The ID of the user to retrieve unread direct messages from. Must be a valid Slack user ID (format: U followed by alphanumeric characters, e.g., U1234567890).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_USER_DND_STATUSRetrieves current Do Not Disturb status for specified Slack users, up to 50 per request.

Input Parameters

string
required
Comma-separated list of users to fetch Do Not Disturb status for
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_GET_USER_PRESENCERetrieves a Slack user’s current real-time presence (e.g., ‘active’, ‘away’) to determine their availability, noting this action does not provide historical data or status reasons.

Input Parameters

string
The ID of the user to query for presence information. This is a string identifier, typically starting with ‘U’ or ‘W’ (e.g., ‘U123ABC456’). If not provided, presence information for the authenticated user will be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_INVITE_USERS_TO_A_CHANNELInvites users to an existing Slack channel using their Slack user IDs. Slack API failures raise an error, which may include per-user invitation failures.

Input Parameters

boolean
When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs. Default is false.
string
Comma-separated string of valid Slack User IDs to invite. Up to 1000 user IDs can be included.
string
ID of the public or private Slack channel to invite users to; must be an existing channel. Typically starts with ‘C’ (public) or ‘G’ (private/group). Bot must already be a member of private channels to invite others. Archived channels will cause failure.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_JOIN_AN_EXISTING_CONVERSATIONJoins an existing Slack conversation (public channel, private channel, or multi-person direct message) by its ID, if the authenticated user has permission. Joining an already-joined channel returns a non-fatal no-op response. Private or restricted channel joins may fail with a permission error.

Input Parameters

string
required
ID of the Slack conversation (public channel, private channel, or multi-person direct message) to join.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LEAVE_CONVERSATIONLeaves a Slack conversation given its channel ID; fails if leaving as the last member of a private channel or if used on a Slack Connect channel.

Input Parameters

string
required
ID of the conversation to leave (e.g., C1234567890).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_ALL_CHANNELSLists conversations available to the authenticated user, with filters for conversation type and archived status. Results are paginated; the created field is a Unix timestamp.

Input Parameters

integer
Maximum number of channels to return per page (1 to 1000). Fewer channels may be returned than requested. This schema defaults to 1 if omitted.
string
Comma-separated list of conversation types to include: public_channel (regular #channels everyone can join), private_channel (invite-only channels), im (1-on-1 direct messages), mpim (group direct messages with 3+ people). Defaults to public_channel if omitted. Private channels, IMs, and MPIMs only appear if the authenticated user/bot is a member and the token has the required scopes; absence from results reflects access limits, not non-existence.
string
Pagination cursor (from a previous response’s next_cursor) for the next page of results. Omit for the first page. Loop on response_metadata.next_cursor until it is empty to retrieve all channels; stopping early silently omits results.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
boolean
Excludes archived channels if true. The API defaults to false (archived channels are included).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_ALL_USERSRetrieves a paginated list of all users with profile details, status, and team memberships in a Slack workspace; data may not be real-time. Filter response fields is_bot, is_app_user, and deleted to build human-only rosters. Profile fields like email and phone may be absent depending on OAuth scopes and workspace privacy settings. Guest/restricted accounts may be omitted based on scopes—do not treat results as a complete directory. High-frequency calls risk HTTP 429; honor the Retry-After header and throttle to ~1–2 requests/second. Use stable user IDs rather than display names for mapping. Prefer SLACK_FIND_USERS for targeted lookups; cache results to avoid full-workspace fetches.

Input Parameters

integer
Maximum number of items to return per page; fewer may be returned if the end of the list is reached. Recommended to set a value (e.g., 100) as Slack may error for large workspaces if omitted.
string
Pagination cursor for fetching subsequent pages. Set to next_cursor from a previous response’s response_metadata. Omit for the first page. Paginate until next_cursor is empty—stopping early silently undercounts users. Page size is capped at ~200 users.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
boolean
Include the locale field for each user. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_AVAILABLE_WORKSPACESLists a page of Slack workspaces authorized for the connection that also appear in the target user’s visible Enterprise Grid memberships. Returns workspace IDs and names with a cursor for further pages; missing membership data yields an empty result.

Input Parameters

string
required
Slack user ID whose Enterprise Grid workspace memberships should be matched against the bot-authorized workspaces, such as U0123456789 or W0123456789.
string
Pagination cursor from response_metadata.next_cursor of a previous response. Omit for the first page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_CANVASESLists accessible Slack Canvases using page-based pagination and optional channel, user and timestamp filters. This deprecated action’s user filter may include canvases accessible to the user, and timestamp filters may not be reliable for canvases.

Input Parameters

integer
Page number for pagination (1-based)
string
Optional user ID to filter canvases created by a specific user. Note: This filter may return canvases accessible to the user (not just created by them) due to Slack API behavior with canvas types.
integer
Maximum number of canvases to return per page (1-1000)
integer
Filter canvases created before this Unix timestamp (inclusive). Pass as integer epoch seconds. Note: This filter may not work reliably for canvas types in the Slack API.
string
Optional channel ID (e.g., ‘C1234567890’) to filter canvases. Must be a channel ID, not name.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
integer
Filter canvases created after this Unix timestamp (inclusive). Pass as integer epoch seconds. Note: This filter may not work reliably for canvas types in the Slack API.
boolean
Display truncated file metadata for older files when workspace has exceeded file limits. When true, shows metadata for files that would normally be hidden due to workspace storage limits.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_CONVERSATIONSLists a page of Slack conversations for a specified user or the authenticated user, with filters for conversation type and archived status. Results contain conversation objects with IDs and may include channel names; access and selected types affect which conversations appear.

Input Parameters

string
The ID of the user whose conversations will be listed. If not provided, conversations for the authenticated user are returned. Non-public channels are restricted to those where the calling user (authenticating user) shares membership.
integer
The maximum number of items to return per page. Must be an integer, typically between 1 and 1000 (e.g., 100). If omitted, the API’s default limit (often 100) applies. Fewer items than the limit may be returned.
string
Comma-separated list of conversation types to include: public_channel (regular #channels everyone can join), private_channel (invite-only channels), im (1-on-1 direct messages), mpim (group direct messages with 3+ people). If omitted, all types are included. If omitted, the API defaults to public_channel only — explicitly specify all desired types to include private channels, DMs, or MPIMs. For im results, only user IDs are returned; use a user-lookup tool to resolve display names.
string
Pagination cursor for retrieving the next set of results. Obtain this from the next_cursor field in a previous response’s response_metadata. If omitted, the first page is fetched. Must loop on next_cursor until it is empty to avoid silently missing conversations.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
boolean
Set to true to exclude archived channels from the list. If false or omitted, archived channels are typically included (the API’s default behavior for omission will apply, usually including them).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_CUSTOM_EMOJISRetrieves all custom emojis for the Slack workspace (image URLs or aliases), not standard Unicode emojis; does not include usage statistics or creation dates.

Input Parameters

boolean
Include a list of categories for Unicode emoji and the emoji in each category. When true, the response will include ‘categories’ and ‘categories_version’ fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_FILES_WITH_FILTERS_IN_SLACKLists files and their metadata within a Slack workspace, filterable by user, channel, timestamp, or type; returns metadata only, not file content. Results are limited to files visible to the authenticated user — files in private channels or restricted to certain members require appropriate membership and permissions. For large workspaces, check paging.pages in the response to determine total pages when paginating.

Input Parameters

string
Specifies the page number of the results to retrieve when paginating. Default is 1.
string
Filter files created by a single user. Provide the Slack User ID.
string
Specifies the number of files to return per page. Default is 100, maximum is 1000.
integer
Filter files created before this Unix timestamp (inclusive).
string
Filter by file type (comma-separated). Valid types: all (everything), spaces (Posts/long-form content), snippets (code snippets), images, pdfs, gdocs (Google Docs), zips. Defaults to ‘all’.
string
Filter files appearing in a specific channel, indicated by its Slack Channel ID.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
integer
Filter files created after this Unix timestamp (inclusive).
boolean
Show truncated file info for files hidden due to being too old or if the team owning the file is over the storage limit.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_LIST_ITEMSLists the rows (items) in a Slack List via slackLists.items.list. Each row exposes column_id-keyed typed values (e.g. rich_text, select, user, date, number); the legacy key/value fields are deprecated. Results are cursor-paginated—you must paginate using response_metadata.next_cursor until it is empty, or rows are silently truncated to the first page. Set archived=true to return archived rows instead of active ones. Requires a user token with the lists:read scope.

Input Parameters

integer
Maximum number of rows (items) to return per page; fewer may be returned if the end of the List is reached. Recommended to set a value (e.g., 100) for large Lists. Use cursor to fetch subsequent pages.
string
Pagination cursor for fetching subsequent pages. Set to next_cursor from a previous response’s response_metadata. Omit for the first page. You MUST paginate until next_cursor is empty—stopping early silently truncates the result to only the first page of rows.
string
required
ID of the Slack List whose rows (items) to fetch, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list.
boolean
When true, return ARCHIVED rows instead of the active (non-archived) rows. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_PINNED_ITEMSRetrieves all messages and files pinned to a specified channel; the caller must have access to this channel.

Input Parameters

string
required
The ID of the channel to retrieve pinned items from. This can be a public channel ID, private group ID, or direct message channel ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_REMINDERSLists all reminders with their details for the authenticated Slack user; returns an empty array if no reminders exist (valid state, not an error). Reminder text is not unique—perform client-side matching on returned objects before extracting a reminder ID for use with SLACK_DELETE_A_SLACK_REMINDER.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_REMOTE_FILESRetrieve information about a team’s remote files.

Input Parameters

integer
The maximum number of items to return.
number
Filter files created before this timestamp (inclusive).
string
Paginate through collections of data by setting the cursor parameter to a next_cursor attribute returned by a previous request’s response_metadata. Default value fetches the first ‘page’ of the collection. See pagination for more detail.
string
Filter files appearing in a specific channel, indicated by its ID.
number
Filter files created after this timestamp (inclusive).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_UNREAD_CHANNEL_MESSAGESLists a page of unread main-timeline messages in a Slack channel for the authenticated user, using the last read position or zero if unavailable. Use the returned cursor to request another page; threaded replies are not included.

Input Parameters

integer
Maximum number of unread messages to return (1-1000). Defaults to 25. Use pagination cursor for additional messages.
string
Pagination cursor from response_metadata.next_cursor of a previous response. Omit for the first page.
string
required
The ID of the channel to fetch unread messages from. Must be a channel, private channel, or group DM that the authenticated user is a member of.
boolean
Return all metadata associated with messages. When true, includes additional metadata fields.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_USER_GROUP_MEMBERSRetrieves a list of all user IDs within a specified Slack user group, with an option to include users from disabled groups.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
required
The encoded ID of the User Group to list users from. This ID is an alphanumeric string.
boolean
Set to true to include users from disabled user groups. If omitted, the default Slack API behavior for handling disabled groups (typically excluding them) will apply.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_USER_GROUPSLists user groups in a Slack workspace, including user-created and default groups, with options to include disabled groups, user IDs, and member counts.

Input Parameters

string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
boolean
Include the number of users in each user group. Defaults to false.
boolean
Include the list of user IDs for each user group. Defaults to false.
boolean
Include disabled user groups in the results. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LIST_USER_REACTIONSLists all reactions added by a specific user to messages, files, or file comments in Slack, useful for engagement analysis when the item content itself is not required. Results are paginated; check response_metadata.next_cursor and iterate with the cursor parameter to retrieve complete reaction history.

Input Parameters

boolean
If true, return the complete reaction list, which may include reactions to deleted items. Significantly inflates payload size; enable only when reactions to deleted items are explicitly needed.
integer
Page number of results to return.
string
Reactions made by this user. Defaults to the authed user.
integer
Number of items to return per page.
integer
Maximum number of items to return; fewer items may be returned. Use with cursor-based pagination.
string
Pagination cursor. Set to next_cursor from a previous response’s response_metadata. See Slack API pagination documentation for details.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_LOOKUP_CANVAS_SECTIONSLooks up section IDs in a Slack Canvas for use with targeted edit operations. Section IDs are needed for insert_after, insert_before, delete, and section-specific replace operations.

Input Parameters

object
required
Search criteria to find sections. Use ‘contains_text’ to search for text within sections. Returns section IDs that match the criteria.
string
required
The unique identifier of the canvas to lookup sections in

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_OPEN_DMOpens or resumes a Slack direct message or multi-person direct message using user IDs or an existing conversation ID. Returns the conversation ID and may indicate that the conversation is already open.

Input Parameters

string
Comma-separated string of user IDs (1 for a DM, or 2-8 for an MPIM) to open/resume a conversation. Order is preserved for MPIMs. Either channel or users must be provided. Accepts list input (will be converted to comma-separated string). Also accepts user_ids as alias. Do not pass emails, display names, or workspace usernames — only Slack user IDs (e.g., U0123456789). Do not provide both users and channel simultaneously.
string
ID or name of an existing DM or MPIM channel to open/resume. Either channel or users must be provided.
boolean
If true, returns the full DM channel object. Applies only when opening a DM via a single user ID in users (not with channel).
boolean
Do not create a direct message or multi-person direct message. This is used to see if there is an existing dm or mpdm.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_PIN_ITEMPins a message to a specified Slack channel; the message must not already be pinned.

Input Parameters

string
required
The ID of the channel where the message will be pinned.
string
required
Timestamp of the message to pin, in ‘epoch_time.microseconds’ format (e.g., ‘1624464000.000200’). This is required by the Slack pins.add API.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_REMOVE_CALL_PARTICIPANTSRegisters participants removed from a Slack call.

Input Parameters

string
required
ID of the call returned by the add method.
string
required
The list of users to remove as participants in the call. users is a JSON array with each user having a slack_id or external_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_REMOVE_REACTION_FROM_ITEMRemoves an emoji reaction from a message, file, or file comment in Slack. Provide exactly one targeting method: channel+timestamp together, file, or file_comment. Mixing methods or omitting all returns invalid_arguments.

Input Parameters

string
ID of the file to remove the reaction from.
string
required
Name of the emoji reaction to remove (e.g., ‘thumbsup’), without colons. Must be Slack’s canonical emoji name; non-canonical names return a ‘no_reaction’ error.
string
Channel ID of the message. Required if timestamp is provided.
string
Timestamp of the message. Required if channel is provided.
string
ID of the file comment to remove the reaction from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_REMOVE_REMOTE_FILERemoves the Slack reference to an external file (which must have been previously added via the remote files API), specified by either its external_id or file ID (one of which is required), without deleting the actual external file.

Input Parameters

string
Slack-specific file ID.
string
Authentication token.
string
Creator-defined, globally unique ID (GUID) for the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_REMOVE_USER_FROM_CONVERSATIONRemoves a specified user from a Slack conversation (channel); the caller must have permissions to remove users and cannot remove themselves using this action.

Input Parameters

string
The ID of the user to be removed from the conversation.
string
ID of the conversation (channel) to remove the user from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RENAME_CONVERSATIONRenames a Slack channel, automatically adjusting the new name to meet naming conventions (e.g., converting to lowercase), which may affect integrations using the old name.

Input Parameters

string
New name for the conversation. Must be 80 characters or less and contain only lowercase letters, numbers, hyphens, and underscores.
string
ID of the conversation (channel) to rename.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RESERVE_FILE_UPLOADReserve a temporary Slack upload URL without uploading bytes. Upload the exact bytes to the returned URL, then call Slack’s files.completeUploadExternal method; Slack aborts reservations that are not completed.

Input Parameters

integer
required
Exact file size in bytes; must be greater than zero.
string
Optional image description for screen readers, at most 1000 characters.
string
required
Name of the file that will be uploaded.
string
Optional Slack syntax type for a text snippet.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RETRIEVE_CONVERSATION_INFORMATIONRetrieves metadata for a Slack conversation by ID, including name, purpose and creation date, with options for member count and locale. Returned fields vary by conversation type and access.

Input Parameters

string
The ID of the conversation (channel, direct message, or multi-person direct message) to retrieve information for. Effectively required — omitting this parameter yields no useful data despite being marked optional.
boolean
If true, the response will include the locale setting for the conversation. Defaults to false.
boolean
If true, the response will include the number of members in the conversation. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RETRIEVE_CONVERSATION_MEMBERS_LISTRetrieves a paginated list of active member IDs (not names, emails, or presence) for a specified Slack public channel, private channel, DM, or MPIM. Returns only user IDs; use a user-lookup tool to enrich member data.

Input Parameters

integer
The maximum number of members to return per page. Fewer items may be returned than the requested limit, even if more members exist and the end of the list hasn’t been reached.
string
Pagination cursor value for fetching specific pages of results. To retrieve the next page, provide the next_cursor value obtained from the response_metadata of the previous API call. If omitted or empty, the first page of members is fetched. For more details on pagination, refer to Slack API documentation. Loop by passing next_cursor into subsequent calls until next_cursor is empty to avoid silently truncating large member lists.
string
ID of the conversation (public channel, private channel, direct message, or multi-person direct message) for which to retrieve the member list. Public channel IDs typically start with ‘C’, private channels or multi-person direct messages (MPIMs) with ‘G’, and direct messages (DMs) with ‘D’. Channel names are NOT accepted — only IDs. Obtain IDs via SLACK_FIND_CHANNELS or SLACK_LIST_CONVERSATIONS. For private channels and MPIMs, the app must have required scopes and be a member of the conversation, otherwise members may not be returned.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RETRIEVE_CURRENT_USER_DND_STATUSRetrieves a Slack user’s current Do Not Disturb (DND) status to determine their availability before interaction; any specified user ID must be a valid Slack user ID.

Input Parameters

string
User ID to fetch DND status for. If not provided, fetches the DND status for the authenticated user.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RETRIEVE_DETAILED_INFORMATION_ABOUT_A_FILERetrieves detailed metadata and paginated comments for a specific Slack file ID; does not download file content.

Input Parameters

string
required
ID of the file to retrieve information for. This is a required field.
integer
Page number of comment results to retrieve. Used for comment pagination. Slack’s default is 1 if not provided. cursor-based pagination is generally preferred.
integer
Number of comments to retrieve per page. Used for comment pagination. Slack’s default is 100 if not provided.
integer
The maximum number of comments to retrieve. This is an upper limit, not a guarantee of how many will be returned. Primarily used for comment pagination.
string
Pagination cursor for retrieving comments. Set to next_cursor from a previous response’s response_metadata to fetch the next page of comments. Essential for navigating through large sets of comments. See pagination for more details.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RETRIEVE_DETAILED_USER_INFORMATIONRetrieves comprehensive information for a valid Slack user ID, excluding message history and channel memberships. Sensitive fields like email and phone require the users:read.email scope and may be silently omitted based on workspace privacy policies.

Input Parameters

string
The ID of the user to retrieve information for. Must be a Slack user ID (U- or W-prefixed); passing emails, display names, or other non-ID strings returns a user_not_found error.
boolean
Set to true to include the user’s locale (e.g., en-US) in the response. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_RETRIEVE_USER_PROFILE_INFORMATIONRetrieves profile information for a specified Slack user (defaults to the authenticated user if user ID is omitted); a provided user ID must be valid. Sensitive fields like email and phone may be silently omitted if required scopes (e.g., users:read.email) are not granted or workspace privacy policies restrict access.

Input Parameters

string
User ID to retrieve profile information for; defaults to the authenticated user.
boolean
Include human-readable labels for custom profile fields. API defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_REVOKE_FILE_PUBLIC_SHARINGRevokes public or external sharing access for a Slack file by its file ID.

Input Parameters

string
required
The ID of the file for which to revoke the public URL. This unique identifier typically starts with ‘F’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SCHEDULE_MESSAGESchedules a message to a Slack channel, DM, or private group for a future time, up to 120 days in advance. Content can be supplied as Markdown, text, blocks, or attachments; Markdown is converted to blocks.

Input Parameters

string
This sends raw text only, use markdown_text field for formatting. Primary text of the message; formatting with mrkdwn applies. Required if blocks and attachments are not provided.
string
Message text treatment: full for special formatting, none otherwise (default). See Slack’s chat.postMessage docs for options.
string
DEPRECATED: Use markdown_text field instead. JSON array of structured blocks as a URL-encoded string for message layout and design. Required if text and attachments are not provided.
string
Channel, private group, or DM channel ID (e.g., C1234567890) or name (e.g., #general) to send the message to. Bot must be a member of the target channel; missing membership returns not_in_channel error. IMPORTANT: org-wide (Enterprise Grid) tokens cannot resolve channel names — Slack returns team_not_found. Pass the channel ID (e.g., C0ABC12345) instead; use SLACK_LIST_ALL_CHANNELS to find IDs.
string
Unix EPOCH timestamp (integer seconds since 1970-01-01 00:00:00 UTC) for the future message send time. Must be strictly greater than current time (past values return time_in_past error). Always convert local times to UTC epoch seconds before use; Slack evaluates in UTC only.
string
Timestamp of the parent message for the scheduled message to be a thread reply. Must be float seconds (e.g., 1234567890.123456).
Pass true to automatically link channel names (e.g., #general) and usernames (e.g., @user). NOTE: This parameter is deprecated by Slack; the linking behavior is primarily controlled by Slack’s default message parsing. For explicit control, use the ‘parse’ parameter instead (set to ‘full’ to enable auto-linking).
string
This is Slack’s legacy ‘secondary attachments’ field for adding rich formatting elements like colored sidebars, structured fields, and author info. Pass as a JSON string array. NOT for file/image uploads. To send files or images, use ‘SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK’ instead.
Pass false to disable automatic link unfurling. Defaults to true. NOTE: Due to a known Slack API limitation, this parameter may not be respected for scheduled messages (works correctly for chat.postMessage but may be ignored by chat.scheduleMessage).
boolean
Pass false to disable automatic media unfurling. Defaults to true. NOTE: Due to a known Slack API limitation, this parameter may not be respected for scheduled messages (works correctly for chat.postMessage but may be ignored by chat.scheduleMessage).
string
PREFERRED: Write your scheduled message in markdown for nicely formatted display. Supports headers (#), bold (text), italic (text), strikethrough (text), code (```), links (text), quotes (>), and dividers (---). Your message will be posted with beautiful formatting.
boolean
With thread_ts, makes reply visible to all in channel, not just thread members. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SEARCH_ALLTool to search all messages and files. Use when you need unified content search across channels and files in one call. Results are scoped to content visible to the authenticated token; missing hits in private or restricted channels reflect permission/membership gaps. Response separates messages and files into distinct sections — explicitly read the files section for document results. Results are index-based and may lag several minutes behind real-time; use SLACK_FETCH_CONVERSATION_HISTORY for near-real-time per-channel coverage. Paginated searches exceeding ~1 req/sec may return HTTP 429 too_many_requests; honor the Retry-After header and resume from the last page.

Input Parameters

integer
Page number of results to return; default is 1. Iterate until total_count or page_count signals completion.
string
Sort by score (relevance) or timestamp (chronological).
integer
Number of results per page; default is 20; max is 100.
string
required
Search query supporting Slack search modifiers/booleans. Date modifiers after:, before:, on: are UTC day-based; after: is exclusive, so convert time ranges to explicit UTC dates to avoid boundary gaps — sub-day precision requires client-side filtering by numeric ts. Spaces act as logical AND; omitting in:#channel or date filters makes search workspace-wide and slow. Malformed modifiers (e.g., wrong from: format) silently return zero results.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
Sort direction: asc or desc.
boolean
If true, search terms are wrapped with markers for client-side highlighting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SEARCH_FILESSearch files visible to the connected Slack user by text and modifiers.

Input Parameters

integer
Page number to return, from 1 to 100.
string ("score" | "timestamp")
Sort matches by relevance score or timestamp.
integer
Number of file matches to return per page, from 1 to 100.
string
required
Slack file search query, including supported search modifiers.
string
Workspace ID required for org-level Enterprise Grid tokens; omit for workspace tokens.
string ("asc" | "desc")
Sort matches in ascending or descending order.
boolean
Wrap matching terms in Slack highlight markers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SEARCH_MESSAGESWorkspace‑wide Slack message search with date ranges and filters. Use query modifiers (e.g., in:#channel, from:@user, before/after:YYYY-MM-DD), sorting (score/timestamp), and pagination.

Input Parameters

integer
Page number for manual pagination control. Cannot be used with auto_paginate - choose either automatic collection OR manual page control, not both.
string
Sort results by score (relevance) or timestamp (chronological).
integer
Without auto_paginate: Number of messages per page (max 100). With auto_paginate: Total messages desired. Set count=500 to get 500 messages with automatic pagination handling.
string
required
Search query supporting various modifiers for precise filtering: Location Modifiers: - in:#channel-name - Messages in specific channel - in:@username - Direct messages with user User Modifiers: - from:@username - Messages from specific user - from:botname - Messages from bot Content Modifiers: - has:link - Messages with links - has:file - Messages with files - has::star: - Starred messages - has::pin: - Pinned messages Special Characters: - "exact phrase" - Search exact phrase - *wildcard - Wildcard matching - -exclude - Exclude words Combinations: Mix modifiers with date filters like "project update" on:2025-09-25 in:#marketing from:@john
string
Cursor for cursor-mark pagination. Use * for the first call, then use next_cursor from the previous response for subsequent calls. This is the modern pagination approach recommended by Slack. Cannot be used with page parameter - choose either cursor-based or page-based pagination.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
Sort direction: asc (ascending) or desc (descending).
boolean
Enable highlighting of search terms in results.
boolean
When enabled, ‘count’ becomes the total messages desired instead of per-page limit. System automatically handles pagination to collect the specified total. Cannot be used with ‘page’ parameter - choose either automatic collection or manual page control. Usage: If you fetched 100 messages but pagination shows 500 total available, set auto_paginate=true and count=500 to get all results at once.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SEND_EPHEMERAL_MESSAGESends an ephemeral message visible only to the specified user in a channel; other channel members cannot see it. Both the bot and the target user must be members of the specified channel.

Input Parameters

string
The message text to display. Required unless ‘blocks’ or ‘attachments’ is provided. When using blocks, this serves as fallback text for notifications. Supports markdown formatting.
string
required
User ID of the user to send the ephemeral message to.
string
Controls text parsing behavior. Use ‘full’ to enable automatic linking of @mentions, #channels, and URLs. Use ‘none’ to disable special parsing (URLs will still be clickable). Defaults to ‘none’.
string
A JSON-based array of structured blocks, presented as a URL-encoded string.
boolean
Legacy parameter for authenticated user authorship. Defaults to true without chat:write:bot scope, false otherwise. Setting to true requires chat:write:user scope for the authenticated user to author the message.
string
required
Channel, private group, or DM channel to send message to. Can be an encoded ID, or a name. IMPORTANT: org-wide (Enterprise Grid) tokens cannot resolve channel names — Slack returns team_not_found. Pass the channel ID (e.g., C0ABC12345) instead; use SLACK_LIST_ALL_CHANNELS to find IDs.
string
URL to an image to use as the icon for this message. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
string
Set your bot’s user name. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
string
Provide another message’s ts value to make this message a reply. Avoid using a reply’s ts value; use its parent instead.
string
Emoji to use as the icon for this message. Overrides icon_url. Must be used in conjunction with as_user set to false, otherwise ignored. See authorship below.
Find and link channel names and usernames.
string
This is Slack’s legacy ‘secondary attachments’ field for adding rich formatting elements like colored sidebars, structured fields, and author info. Pass as a JSON string array. NOT for file/image uploads. To send files or images, use ‘SLACK_UPLOAD_OR_CREATE_A_FILE_IN_SLACK’ instead.
string
PREFERRED: Write your ephemeral message in markdown for nicely formatted display. Supports: headers (# ## ###), bold (text or text), italic (text or text), strikethrough (text), inline code (code), code blocks (```), links (text), block quotes (>), lists (- item, 1. item), dividers (--- or ***). IMPORTANT: Use \n for line breaks (e.g., ‘Line 1\nLine 2’), not actual newlines. Incompatible with blocks or text parameters. Maximum 12,000 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SEND_ME_MESSAGESends a ‘me message’ (e.g., ‘/me is typing’) to a Slack channel, where it’s displayed as a third-person user action; messages are plain text and the channel must exist and be accessible.

Input Parameters

string
Content of the ‘me message’, displayed as an action performed by the user (e.g., if text is ‘is feeling happy’, it appears as ‘User is feeling happy’).
string
Specifies the target channel by its public ID (e.g., ‘C1234567890’), private group ID, IM channel ID, or name (e.g., ‘#general’, ‘@username’). IMPORTANT: org-wide (Enterprise Grid) tokens cannot resolve channel names — Slack returns team_not_found. Pass the channel ID (e.g., C0ABC12345) instead; use SLACK_LIST_ALL_CHANNELS to find IDs.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SEND_MESSAGEPosts a message to a Slack channel, DM, or private group. Provide exactly one visible content mode: markdown_text for normal Markdown content, or blocks for raw Slack Block Kit layouts. Use fallback_text only with blocks; it maps to Slack’s top-level text fallback. Fails with not_in_channel, channel_not_found, or channel_is_archived if the bot lacks access. Rate-limited at ~1 req/sec (HTTP 429, honor Retry-After). Not idempotent — duplicate calls post duplicate messages.

Input Parameters

array
Use this instead of markdown_text only when you need Slack Block Kit capabilities that Markdown cannot express: buttons, approval/reject actions, select menus, checkboxes, radio buttons, date/time pickers, overflow menus, interactive workflow payloads, section accessories, image/video blocks, context rows, two-column fields, multiple action buttons in one row, or rich card-like layouts. Provide raw Slack Block Kit JSON as an array. For normal prose generated by an LLM inside a blocks payload, prefer a Slack markdown block: {‘type’: ‘markdown’, ‘text’: ’# Heading\n\nBody text’}. Do not use this together with markdown_text. If these blocks are the visible content, provide fallback_text when notification/accessibility fallback matters.
string
required
ID or name of the channel, private group, or IM channel to send the message to. Can be specified as either ‘channel’ or ‘channel_id’. Do NOT include the ’#’ prefix (e.g., use ‘general’ not ‘#general’) - any leading ’#’ will be automatically stripped. For DMs, use the channel ID returned by SLACK_OPEN_DM (starts with ‘D’); usernames, emails, and user IDs are not valid DM targets. IMPORTANT: org-wide (Enterprise Grid) tokens cannot resolve channel names — Slack returns team_not_found. Pass the channel ID (e.g., ‘C0ABC12345’) instead; use SLACK_LIST_ALL_CHANNELS to find IDs.
string
Timestamp (ts) of an existing message to make this a threaded reply. Use ts of the parent message, not another reply. Example: ‘1476746824.000004’.
Enable unfurling of text-based URLs. Defaults false for bots, true if as_user is true.
boolean
Enable media previews (images, videos) from URLs. Set to true (default) to show media previews, false to hide them.
string
Optional only when using blocks. Maps to Slack’s top-level text field for notifications, accessibility, search previews, and clients that cannot render blocks. This should be a short plain-text summary of the block content, not another visible message body. Omit it if you want Slack to infer fallback text from supported blocks.
string
Use this for normal LLM-written message content. Pass standard Markdown exactly as written; this tool sends it to Slack’s native markdown_text argument without converting it to blocks. Do not use this together with blocks. Supports Slack’s native markdown handling for headings, bold, italic, links, lists, code, quotes, dividers, tables, and task lists. Slack collapses literal empty Markdown lines; to force visible blank spacer rows, put a non-breaking space on each spacer line, e.g. a\n\u00a0\n\u00a0\n\u00a0\nb. For Slack mentions, use explicit entity syntax such as <@USER_ID>, <#CHANNEL_ID>, or <!subteam^GROUP_ID>; do not rely on @name or #name auto-linking. Use blocks instead when you need buttons, selects, checkboxes, image blocks, context rows, fields, accessories, or other interactive/layout controls.
boolean
If true for a threaded reply, also posts to main channel. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SET_CONVERSATION_PURPOSESets the purpose (a short description of its topic/goal, displayed in the header) for a Slack conversation; the calling user must be a member.

Input Parameters

string
The ID of the conversation (channel, direct message, or group message) to set the purpose for.
string
The new purpose for the conversation. This text will be displayed as the channel description. The maximum length is 250 characters.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SET_LIST_ACCESSGrants or sets sharing access on a Slack List via slackLists.access.set. Grant read, write, or owner access to either channels (channel_ids) or users (user_ids) — exactly one of the two is required. The owner level is user-only and subject to additional server-side rules. Requires a user token with the lists:write scope.

Input Parameters

string
required
ID of the Slack List to set sharing access on, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list.
array
IDs of the users to grant access to. Mutually exclusive with channel_ids: EXACTLY ONE of channel_ids or user_ids is required — supplying both or neither returns invalid_parameters from the API. Required when the access_level is owner.
array
IDs of the channels to grant access to. Mutually exclusive with user_ids: EXACTLY ONE of channel_ids or user_ids is required — supplying both or neither returns invalid_parameters from the API. Cannot be combined with the owner access level.
string
required
The access level to grant on the List. One of read, write, or owner. read grants view-only access; write grants edit access. owner is USER-ONLY: it must be paired with user_ids (not channel_ids) — supplying channel_ids together with owner returns invalid_arguments from the API. Only the List’s current owner can assign the owner level, and cross-team owner upgrades are disallowed. The exactly-one-target rule and the owner->user_ids requirement are validated client-side here; the ownership/cross-team rules remain enforced server-side by Slack.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SET_READ_CURSOR_IN_A_CONVERSATIONMarks a message, specified by its timestamp (ts), as the most recently read for the authenticated user in the given channel, provided the user is a member of the channel and the message exists within it.

Input Parameters

string
The timestamp of the message to mark as the most recently read. Must be a Slack timestamp string with microsecond precision in the format ‘UNIX_TIMESTAMP.MICROSECONDS’ (e.g., ‘1625800000.000200’).
string
The ID of the public channel, private channel, or direct message to set the read cursor for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATIONSets or updates the topic for a specified Slack conversation.

Input Parameters

string
The new topic for the conversation. It must be a string up to 250 characters long. Text formatting and linkification are not supported.
string
The ID of the public channel, private channel, direct message, or multi-person direct message conversation for which the topic will be set. Must be a channel ID (C/G/D prefix), not a human-readable name like ‘#general’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SET_USER_ACTIVETool to mark a user as active in Slack. Note: This endpoint is deprecated and non-functional - it exists for backwards compatibility but does not perform any action.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SET_USER_PRESENCEManually sets a user’s Slack presence, overriding automatic detection; this setting persists across connections but can be overridden by user actions or Slack’s auto-away (e.g., after 10 mins of inactivity).

Input Parameters

string ("auto" | "away")
required
The presence state to set for the user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_SHARE_REMOTE_FILEShares a remote file, which must already be registered with Slack, into specified Slack channels or direct message conversations.

Input Parameters

string
The unique ID of the remote file registered with Slack. Either this file field or the external_id field (or both) is required to identify the file.
string
required
A comma-separated list of channel IDs where the remote file will be shared. These can include public channel IDs, private channel IDs, or direct message channel IDs.
string
The globally unique identifier (GUID) for the remote file, as provided by the app that registered it with Slack. Either this external_id field or the file field (or both) is required to identify the file.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_START_CALLRegisters a new call in Slack using calls.add for third-party call integration; created_by is required if not using a user-specific token.

Input Parameters

string
The name or title for the call. This will be displayed in Slack to identify the call.
string
A JSON string representing an array of user objects to be registered as participants in the call. Each user object in the array should define a participant using their slack_id (Slack User ID) and/or an external_id (an identifier from the third-party application, unique to that user within that application). For instance: '''[{"slack_id": "U012A3BCD4E"}, {"external_id": "user-xyz@example.com", "slack_id": "U012A3BCD4F"}]'''.
string
required
The URL required for a client to join the call (e.g., a web join link). This field is mandatory. Must be a valid third-party call system URL (e.g., web join link), not a Slack channel or message URL.
string
Slack user ID of the creator; optional (defaults to authenticated user) if using a user token, otherwise required.
integer
The start time of the call, specified as a UTC UNIX timestamp in seconds. For example, 1678886400 corresponds to March 15, 2023, at 12:00 PM UTC.
string
required
A unique identifier for the call, supplied by the third-party call provider. This ID must be unique across all calls from that specific service. This field is required.
string
An optional, human-readable identifier for the call, supplied by the third-party call provider. If provided, this ID will be displayed in the Slack call object interface.
string
An optional URL that, when provided, allows Slack clients to attempt to directly launch the third-party call application. This is typically a deep link URI for the specific application.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UNARCHIVE_CHANNELReverses conversation archival.

Input Parameters

string
required
ID of conversation to unarchive

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UNPIN_ITEMUnpins a message, identified by its timestamp, from a specified channel if the message is currently pinned there; this operation is destructive.

Input Parameters

string
required
The ID of the channel where the message is pinned (e.g., a public channel, private channel, or direct message).
string
required
Timestamp of the message to unpin. This is required to identify the specific message to be removed from the channel’s pinned items.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPDATE_CALL_INFOUpdates the title, join URL, or desktop app join URL for an existing Slack call identified by its ID.

Input Parameters

string
required
Unique identifier of the call to update, obtained when a call is created (e.g., via calls.add Slack API method).
string
New title for the call.
string
New URL for clients to join the call.
string
URL to directly launch the third-party call application from Slack clients.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPDATE_LISTUpdates a Slack List’s metadata via slackLists.update. Only the List’s name, description_blocks, and todo_mode are editable here. The List to update is identified by its id (not list_id). Descriptions are rich text — a plain string is wrapped into a rich_text block automatically. Requires a user token with the lists:write scope.

Input Parameters

string
required
ID of the Slack List to update, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list. NOTE: the parameter is named id (not list_id) for this method — pass the List ID here.
string
New name (title) for the List. Omit to leave the List name unchanged.
boolean
Whether the List is in to-do mode (rows behave like checkable tasks). Set true to enable to-do mode or false to disable it. Omit to leave it unchanged.
string
New description for the List. List descriptions are always rich text (Block Kit rich_text). For convenience you may supply a plain string and it will be wrapped into a rich_text block automatically; you may also pass an already-formed rich_text block dict or a list of blocks, which is sent through unchanged. Omit to leave the description unchanged.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPDATE_LIST_ITEMUpdates one or more cells in an EXISTING Slack List row via slackLists.items.update. Each cell is identified by row_id (an existing row ID matching ^Rec[A-Z0-9]{8,}$) and column_id and carries a typed value; text columns require Block Kit rich_text (a plain string is wrapped automatically), and select takes the column’s choice values (e.g. ["todo"]). Use it to UPDATE existing rows; the live API rejects row_id_to_create inside a cell (despite Slack’s inline example), so to ADD a row use create_slack_list_item. Requires a user token with the lists:write scope.

Input Parameters

array
required
The cells to write. Each cell object identifies a single cell by its row_id and column_id and carries a typed value for that column. Text columns must use Block Kit rich_text (the plain text property is not accepted on input) — for convenience a cell may instead supply a plain string text and it will be wrapped into a rich_text block automatically. Other column types use their typed key, e.g. select, user, date, number, checkbox. For select, pass an array of the column’s choice VALUES (e.g. ["todo"]) — Slack does not mint separate per-option IDs. UPDATE existing rows: each cell’s row_id must be an EXISTING row ID matching ^Rec[A-Z0-9]{8,}$ (as returned by create_slack_list_item / list_slack_list_items). Do NOT try to create rows here: the live API rejects row_id_to_create inside a cell (invalid additional property at /cells/N), despite Slack’s inline example showing it. To ADD a row, use create_slack_list_item (the reliable path).
string
required
ID of the Slack List that contains the row(s) to update, e.g. ‘F0123456789’. This is the List file ID returned by create_slack_list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPDATE_REMOTE_FILEUpdates metadata or content details for an existing remote file in Slack; this action cannot upload new files or change the fundamental file type.

Input Parameters

string
Slack’s unique identifier for the remote file (e.g., F12345678). Used to identify the file if external_id is not provided. One of file or external_id is required to specify the file to update.
string
New title for the remote file. If omitted, the current title remains unchanged.
string
Authentication token for authorizing the API request to Slack.
string
New filetype for the remote file. This typically describes the kind of file, e.g., pdf, gdoc, image, text. See Slack API documentation for specific supported filetype values. Providing an inaccurate filetype might affect how the file is handled or displayed.
string
Creator-defined Globally Unique Identifier (GUID) for the remote file. Used to identify the file if file ID is not provided. One of file or external_id is required to specify the file to update.
string
New publicly accessible URL for the remote file. If provided, this updates the link associated with the file in Slack.
string
A string that references the new preview image for the document. The referenced image data will be sent as multipart/form-data. This could be a local file path (if supported by the client), a public URL, or base64 encoded image data. Max 1MB. Updates the file’s preview in Slack.
string
Plain text content extracted from the remote file, used by Slack to improve searchability. This can be a summary or the full text. Maximum 1MB. If provided, updates the searchable content.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPDATES_A_MESSAGEUpdates a Slack message by timestamp. Provide exactly one visible content mode: markdown_text for normal Markdown content, or blocks for raw Slack Block Kit layouts. Use fallback_text only with blocks; it maps to Slack’s top-level text fallback.

Input Parameters

string
required
Timestamp of the message to update (string, Unix time with microseconds, e.g., '1234567890.123456').
array
Use this instead of markdown_text only when updating to Slack Block Kit capabilities that Markdown cannot express: buttons, approval/reject actions, select menus, checkboxes, radio buttons, date/time pickers, overflow menus, interactive workflow payloads, section accessories, image/video blocks, context rows, two-column fields, multiple action buttons in one row, or rich card-like layouts. Provide raw Slack Block Kit JSON as an array. For normal prose generated by an LLM inside a blocks payload, prefer a Slack markdown block: {‘type’: ‘markdown’, ‘text’: ’# Heading\n\nBody text’}. Do not use this together with markdown_text. If these blocks are the visible content, provide fallback_text when notification/accessibility fallback matters.
boolean
Pass true to update the message as the authenticated user; applicable to bot users as well.
string
required
ID or name of the channel, private group, or IM channel containing the message to update. Can be specified as either ‘channel’ or ‘channel_id’. Do NOT include the ’#’ prefix (e.g., use ‘general’ not ‘#general’) - any leading ’#’ will be automatically stripped.
array
Array of file IDs to attach to the updated message. Files must already be uploaded to Slack.
object
JSON object containing event_type (string) and event_payload (dict) fields for adding custom metadata to the message.
string
Optional only when using blocks. Maps to Slack’s top-level text field for notifications, accessibility, search previews, and clients that cannot render blocks. This should be a short plain-text summary of the block content, not another visible message body. Omit it if you want Slack to infer fallback text from supported blocks.
string
Use this for normal LLM-written updated message content. Pass standard Markdown exactly as written; this tool sends it to Slack’s native markdown_text argument without converting it to blocks. Do not use this together with blocks. Supports Slack’s native markdown handling for headings, bold, italic, links, lists, code, quotes, dividers, tables, and task lists. Slack collapses literal empty Markdown lines; to force visible blank spacer rows, put a non-breaking space on each spacer line, e.g. a\n\u00a0\n\u00a0\n\u00a0\nb. For Slack mentions, use explicit entity syntax such as <@USER_ID>, <#CHANNEL_ID>, or <!subteam^GROUP_ID>; do not rely on @name or #name auto-linking. Use blocks instead when you need buttons, selects, checkboxes, image blocks, context rows, fields, accessories, or other interactive/layout controls.
boolean
If true and the message is a thread reply, broadcast the updated message to the channel. Defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPDATE_USER_GROUPUpdates an existing Slack User Group, which must be specified by an existing usergroup ID, with new optional details such as its name, description, handle, or default channels.

Input Parameters

string
New name for the User Group. Must be unique among User Groups.
string
New mention handle. Must be unique among channels, users, and User Groups.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
Comma-separated encoded channel IDs to set as default channels.
string
required
Encoded ID of the existing User Group to update.
string
New short description for the User Group.
boolean
If true, include the number of users in the User Group in the response.
boolean
Configure this user group to show as a sidebar section for all group members. Only relevant if group has 1 or more default channels added.
string
Comma-separated encoded channel IDs for which the User Group can custom add usergroup members to.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPDATE_USER_GROUP_MEMBERSReplaces the members of an existing Slack User Group with a complete list of user IDs. The list cannot be empty; guests and bot users cannot be added.

Input Parameters

string
required
Comma-separated string of encoded user IDs for the new, complete member list, replacing all existing members. User IDs typically start with ‘U’ or ‘W’.
string
ID of the Slack workspace (team) to operate on, e.g. T0123456789. Use only with org-level Enterprise Grid tokens when you need to target a specific workspace; omit for single-workspace tokens.
string
required
The encoded ID of the User Group whose members are to be updated. This ID typically starts with ‘S’.
boolean
If true, the response usergroup object includes user_count and potentially channel_count fields, reflecting counts after the update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: SLACKBOT_UPLOAD_OR_CREATE_A_FILE_IN_SLACKUpload files, images, screenshots, documents, or any media to Slack channels or threads. Supports all file types including images (PNG, JPG, JPEG, GIF), documents (PDF, DOCX, TXT), code files, and more. Can share files publicly in channels or as thread replies with optional comments. Large files may fail with upload_too_large; use SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE for large uploads. If the API returns ok=false with method_deprecated, fall back to SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE or SLACK_SEND_MESSAGE with a URL.

Input Parameters

string
File(s) to upload. Accepts a single file or a list of files. At least one of ‘content’ or ‘file’ must be provided (but not both). The file name will be used in Slack.
string
Title of the file, displayed in Slack.
string
Authentication token; requires ‘files:write’ scope.
array
Slack Block Kit blocks for the message that shares the file. Provide a JSON array of block objects. Ignored by Slack when initial_comment is also provided.
string
Text content of the file; use for text-based files. At least one of ‘content’ or ‘file’ must be provided (but not both).
string
Channel ID where the file will be shared; if omitted, file is private to the uploader. Accepts the singular channel or plural channels for backward compatibility. Use channel ID (e.g., C1234567890) not channel name. Note: Due to API changes, only the first channel ID is used if multiple are provided. App must be a member of the target channel or the upload fails with not_in_channel or channel_not_found.
string
Filename to be displayed in Slack. Required when using ‘content’ parameter.
string
Deprecated: File type detection is now automatic. This parameter is preserved for backward compatibility but no longer affects file uploads.
string
Timestamp of a parent message to upload this file as a reply; use the original message’s ‘ts’ value (e.g., ‘1234567890.123456’).
string
Optional message to introduce the file in specified ‘channels’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: SLACKBOT_CHANNEL_CREATEDType: webhookTriggered when a new channel is created in Slack.

Payload

integer
required
The timestamp of when the channel was created, formatted as a Unix timestamp
string
required
The ID of the user who created the channel
string
required
The ID of the channel
string
required
The name of the channel
Slug: SLACKBOT_CHANNEL_MESSAGE_RECEIVEDType: webhookTriggered when a message is posted in a Slack channel (public, private, or multi-party IM). Does NOT match direct messages.

Configuration

string
Specific channel to watch. Null = all channels.
string ("channel" | "group" | "mpim")
Filter by channel type. channel = public, group = private, mpim = multi-party IM. Null = all types.
boolean
Filter by message source. true = only bot messages, false = only human messages, null = all.
boolean
Filter by thread status. true = only thread replies, false = only top-level, null = all.

Payload

array
array
string
string
required
string
array
string
string
string
string
string
required
string
Slug: SLACKBOT_DIRECT_MESSAGE_RECEIVEDType: webhookTriggered when a new direct message (DM) is sent to a user in Slack. Catches all DMs across all DM channels, including thread replies.

Configuration

boolean
Filter by thread status. true = only thread replies, false = only top-level, null = all.

Payload

array
Attachments included with the direct message, if any. Some Slack apps (like Datadog) send content via attachments rather than the top-level text field.
array
Block Kit blocks of the direct message, if any.
string
required
The ID of the bot that sent the direct message
string
required
The ID of the direct message channel
string
required
The type of the channel (should be ‘im’ for direct messages)
array
Files uploaded with the direct message, if any. Present when subtype is ‘file_share’. Contains file metadata including name, mimetype, and URLs.
string
The ID of the user who sent the parent message. Present only when the direct message is a thread reply.
string
The message subtype (e.g. ‘bot_message’, ‘file_share’), if any.
string
required
The ID of the team where the direct message was sent
string
required
The text content of the direct message
string
The timestamp of the parent message. Present only when the direct message is a thread reply.
string
required
The timestamp of the direct message
string
required
The ID of the user who sent the direct message
Slug: SLACKBOT_MESSAGE_REACTION_ADDEDType: webhookTriggered when a reaction is added to a message in Slack. Supports optional filtering by channel and emoji name.

Configuration

string
Specific channel to watch. Null = all channels.
string
Filter by emoji short name (e.g. ‘thumbsup’, ‘tada’). Null = all reactions.

Payload

string
required
The timestamp of the reaction event
string
required
The ID of the channel where the reacted-to message is located
string
required
The timestamp of the message that was reacted to
string
The ID of the user who owns the message that was reacted to
string
required
The emoji short name of the reaction that was added
string
The ID of the team where the reaction occurred
string
required
The ID of the user who added the reaction
Slug: SLACKBOT_MESSAGE_REACTION_REMOVEDType: webhookTriggered when a reaction is removed from a message in Slack. Supports optional filtering by channel and emoji name.

Configuration

string
Specific channel to watch. Null = all channels.
string
Filter by emoji short name (e.g. ‘thumbsup’, ‘tada’). Null = all reactions.

Payload

string
required
The timestamp of the reaction event
string
required
The ID of the channel where the reacted-to message is located
string
required
The timestamp of the message that was reacted to
string
The ID of the user who owns the message that was reacted to
string
required
The emoji short name of the reaction that was removed
string
The ID of the team where the reaction occurred
string
required
The ID of the user who removed the reaction
Slug: SLACKBOT_REACTION_ADDEDType: webhookDEPRECATED: use SLACK_MESSAGE_REACTION_ADDED instead.Triggered when a reaction is added to a message in Slack.

Payload

string
required
The ID of the bot that posted the message
string
required
The type of the channel where the message was posted
string
required
The timestamp of the reaction event. Formatted as a Unix timestamp
string
required
The ID of the channel where the message that was reacted to is located
string
required
The timestamp of the message that was reacted to. Formatted as a Unix timestamp
string
The ID of the user who owns the message that was reacted to. Slack omits this for reactions on items posted without an owning user (e.g. file shares, system messages, or app-posted messages).
string
required
The type of reaction that was added
string
required
The ID of the team where the message was posted
string
required
The ID of the user who added the reaction
Slug: SLACKBOT_REACTION_REMOVEDType: webhookDEPRECATED: use SLACK_MESSAGE_REACTION_REMOVED instead.Triggered when a reaction is removed from a message.

Payload

string
required
The ID of the bot that posted the message
string
required
The type of the channel where the message was posted
string
required
The timestamp of the reaction event. Formatted as a Unix timestamp
string
required
The ID of the channel where the message that was reacted to is located
string
required
The timestamp of the message that was reacted to. Formatted as a Unix timestamp
string
The ID of the user who owns the message that was reacted to. Slack omits this for reactions on items posted without an owning user (e.g. file shares, system messages, or app-posted messages).
string
required
The type of reaction that was added
string
required
The ID of the team where the message was posted
string
required
The ID of the user who added the reaction
Slug: SLACKBOT_RECEIVE_BOT_MESSAGEType: webhookDEPRECATED: use SLACK_CHANNEL_MESSAGE_RECEIVED with is_bot_message=true instead.Triggered when a new bot message is posted to a Slack channel.

Payload

array
Attachments included with the bot message, if any. Slack apps (like Datadog) often send their content via attachments rather than the top-level text field.
string
The ID of the bot that posted the message
string
required
The ID of the channel where the bot message was posted
string
The type of the channel where the bot message was posted
array
Files uploaded with the bot message, if any. Present when subtype is ‘file_share’. Contains file metadata including name, mimetype, and URLs.
string
required
The subtype of the message (should be ‘bot_message’)
string
The ID of the team where the bot message was posted
string
required
The text content of the bot message
string
required
The timestamp of the bot message
string
The username of the bot that posted the message
Slug: SLACKBOT_RECEIVE_MESSAGEType: webhookDEPRECATED: use SLACK_CHANNEL_MESSAGE_RECEIVED instead.Triggered when a new message is posted to a Slack channel.

Payload

array
Attachments included with the message, if any. Some Slack apps (like Datadog) send content via attachments rather than the top-level text field.
string
The ID of the bot that posted the message
string
required
The ID of the channel where the message was posted
string
The type of the channel where the message was posted
array
Files uploaded with the message, if any. Present when subtype is ‘file_share’. Contains file metadata including name, mimetype, and URLs.
string
The ID of the team where the message was posted
string
required
The text content of the message
string
required
The timestamp of the message
string
The ID of the user who posted the message