- Category: team chat
- Auth: OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 104
- Triggers: 9
- Slug:
SLACKBOT - Version: 20261101_00
Frequently Asked Questions
Slackbot triggers require a verification token or subscription ID in custom auth
Slackbot triggers require a verification token or subscription ID in custom auth
Why can repeated Slackbot connections make older connections expire?
Why can repeated Slackbot connections make older connections expire?
Tools
Add call participants
Add call participants
SLACKBOT_ADD_CALL_PARTICIPANTSRegisters new participants added to a Slack call.Input Parameters
slack_id. For example: [{"slack_id": "U1H77"}] or [{"slack_id": "U1H77"}, {"slack_id": "U2ABC123"}].Output
Add reaction to message
Add reaction to message
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
Output
Add a remote file
Add a remote file
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
Output
Archive a Slack conversation
Archive a Slack conversation
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
Output
Close conversation channel
Close conversation channel
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
Output
Complete external file upload
Complete external file upload
Create a reminder
Create a reminder
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
Output
Create Slack Canvas
Create Slack Canvas
Create channel
Create channel
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
Output
Create Slack List
Create Slack List
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
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.include_copied_list_records to also copy its rows.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.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
Create Slack List item
Create Slack List item
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
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.initial_fields may still be supplied to override copied values.Output
Create a Slack user group
Create a Slack user group
SLACKBOT_CREATE_USER_GROUPCreates a new User Group (often referred to as a subteam) in a Slack workspace.Input Parameters
Output
Customize URL unfurl
Customize URL unfurl
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
channel, or alternatively provide unfurl_id and source together.ts, or alternatively provide unfurl_id and source together.unfurls or metadata is required. Pass as a JSON string.source. Alternative to using channel and ts parameters.user_auth_required is true.user_auth_message for richer formatting. Used when user_auth_required is true.user_auth_required is true and authorization is pending.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
Delete Slack Canvas
Delete Slack Canvas
Delete a file by ID
Delete a file by ID
Delete file comment
Delete file comment
SLACKBOT_DELETE_FILE_COMMENTDeletes a specific comment from a file in Slack; this action is irreversible.Input Parameters
files.info method or when a file is shared.Output
Delete Slack List access
Delete Slack List access
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
channel_ids: provide EXACTLY ONE of user_ids or channel_ids. Supplying both, or neither, causes the API to return an invalid_parameters error.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
Delete Slack List item
Delete Slack List item
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
Output
Delete multiple Slack List items
Delete multiple Slack List items
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
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).ids must belong to this List.Output
Delete a Slack reminder
Delete a Slack reminder
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
Output
Delete a message from a chat
Delete a message from a chat
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
ts; ephemeral messages and certain app-posted messages cannot be deleted via this method even with a valid timestamp.Output
Delete scheduled chat message
Delete scheduled chat message
SLACKBOT_DELETE_SCHEDULED_MESSAGEDeletes a pending, unsent scheduled message from the specified Slack channel, identified by its scheduled_message_id.Input Parameters
scheduled_message_id) of the message to be deleted; obtained from chat.scheduleMessage response.Output
Disable a Slack user group
Disable a Slack user group
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
Output
Download Slack file
Download Slack file
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
cursor-based pagination is generally preferred.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
Edit Slack Canvas
Edit Slack Canvas
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
Output
Enable a user group
Enable a user group
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
Output
End a call
End a call
Fetch conversation history
Fetch conversation history
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 threadInput Parameters
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.Output
Fetch item reactions
Fetch item reactions
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
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.Output
Retrieve conversation replies
Retrieve conversation replies
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
response_metadata.next_cursor of a previous response to get subsequent pages. If omitted, fetches the first page.not_in_channel/channel_not_found.latest or oldest timestamps in results. Effective only if latest or oldest is specified.Output
Fetch team info
Fetch team info
SLACKBOT_FETCH_TEAM_INFOFetches comprehensive metadata about the current Slack team, or a specified team if the provided ID is accessible.Input Parameters
Output
Find channels
Find channels
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
public_channel, private_channel, mpim (multi-person direct message), im (direct message). Defaults to public and private channels.Output
Lookup users by email
Lookup users by email
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
Output
Find users
Find users
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
Output
Fetch bot user information
Fetch bot user information
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
Output
Retrieve call information
Retrieve call information
Get Slack Canvas (Deprecated)
Get Slack Canvas (Deprecated)
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
Output
Get Slack List item
Get Slack List item
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
id of a row previously returned by create_slack_list_item or a List-items listing call.record includes an is_subscribed flag indicating whether the calling user is subscribed to that item. Defaults to false.Output
Get reminder information
Get reminder information
SLACKBOT_GET_REMINDERRetrieves detailed information for an existing Slack reminder specified by its ID; this is a read-only operation.Input Parameters
Output
Get remote file
Get remote file
Retrieve team profile details
Retrieve team profile details
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
Output
Get unread messages from user
Get unread messages from user
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
Output
Get team DND status
Get team DND status
SLACKBOT_GET_USER_DND_STATUSRetrieves current Do Not Disturb status for specified Slack users, up to 50 per request.Input Parameters
Output
Retrieve user presence
Retrieve user presence
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
Output
Invite users to a Slack channel
Invite users to a Slack channel
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
Output
Join conversation by channel id
Join conversation by channel id
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
Output
Leave conversation channel
Leave conversation channel
List all channels
List all channels
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
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.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.Output
List all users
List all users
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
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.Output
List available workspaces
List available workspaces
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
Output
List Slack Canvases (Deprecated)
List Slack Canvases (Deprecated)
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
Output
List conversations
List conversations
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
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.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.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
List team custom emojis
List team custom emojis
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
Output
List Slack files
List Slack files
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
all (everything), spaces (Posts/long-form content), snippets (code snippets), images, pdfs, gdocs (Google Docs), zips. Defaults to ‘all’.Output
List Slack List items
List Slack List items
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
cursor to fetch subsequent pages.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.false.Output
List pinned items in a channel
List pinned items in a channel
List reminders
List reminders
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
Output
List remote files
List remote files
SLACKBOT_LIST_REMOTE_FILESRetrieve information about a team’s remote files.Input Parameters
Output
List unread channel messages
List unread channel messages
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
Output
List all users in a user group
List all users in a user group
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
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
List user groups
List user groups
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
Output
List user reactions
List user reactions
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
next_cursor from a previous response’s response_metadata. See Slack API pagination documentation for details.Output
Lookup Canvas Sections
Lookup Canvas Sections
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
Output
Open DM
Open DM
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
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.channel or users must be provided.true, returns the full DM channel object. Applies only when opening a DM via a single user ID in users (not with channel).Output
Pin an item to a channel
Pin an item to a channel
Remove call participants
Remove call participants
Remove reaction from item
Remove reaction from item
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
Output
Remove remote file
Remove remote file
Remove user from conversation
Remove user from conversation
Rename a conversation
Rename a conversation
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
Output
Reserve Slack file upload
Reserve Slack file upload
Retrieve conversation information
Retrieve conversation information
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
Output
Get conversation members
Get conversation members
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
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.Output
Retrieve user DND status
Retrieve user DND status
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
Output
Retrieve detailed file information
Retrieve detailed file information
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
cursor-based pagination is generally preferred.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
Retrieve detailed user information
Retrieve detailed user information
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
user_not_found error.Output
Retrieve user profile information
Retrieve user profile information
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
Output
Revoke a file's public url
Revoke a file's public url
Schedule message
Schedule message
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
mrkdwn applies. Required if blocks and attachments are not provided.full for special formatting, none otherwise (default). See Slack’s chat.postMessage docs for options.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.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.time_in_past error). Always convert local times to UTC epoch seconds before use; Slack evaluates in UTC only.1234567890.123456).thread_ts, makes reply visible to all in channel, not just thread members. Defaults to false.Output
Search all content
Search all content
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
Output
Search Slack files
Search Slack files
Search messages
Search messages
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
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* 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.Output
Send ephemeral message
Send ephemeral message
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
team_not_found. Pass the channel ID (e.g., C0ABC12345) instead; use SLACK_LIST_ALL_CHANNELS to find IDs.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
Send message
Send message
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
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.team_not_found. Pass the channel ID (e.g., ‘C0ABC12345’) instead; use SLACK_LIST_ALL_CHANNELS to find IDs.ts) of an existing message to make this a threaded reply. Use ts of the parent message, not another reply. Example: ‘1476746824.000004’.true (default) to show media previews, false to hide them.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.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.Output
Set a conversation's purpose
Set a conversation's purpose
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
Output
Set Slack List access
Set Slack List access
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
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.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.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
Set conversation read cursor
Set conversation read cursor
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
Output
Set conversation topic
Set conversation topic
SLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATIONSets or updates the topic for a specified Slack conversation.Input Parameters
Output
Mark user as active
Mark user as active
Set user presence
Set user presence
Start call
Start call
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
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"}]'''.1678886400 corresponds to March 15, 2023, at 12:00 PM UTC.Output
Unarchive channel
Unarchive channel
Unpin message from channel
Unpin message from channel
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
Output
Update call information
Update call information
Update Slack List
Update Slack List
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
id (not list_id) for this method — pass the List ID here.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
Update Slack List item
Update Slack List item
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
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).Output
Update an existing remote file
Update an existing remote file
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
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.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.file ID is not provided. One of file or external_id is required to specify the file to update.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.Output
Update a Slack message
Update a Slack message
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
'1234567890.123456').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.event_type (string) and event_payload (dict) fields for adding custom metadata to the message.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.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.true and the message is a thread reply, broadcast the updated message to the channel. Defaults to false.Output
Update Slack user group
Update Slack user group
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
Output
Update user group members
Update user group members
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
usergroup object includes user_count and potentially channel_count fields, reflecting counts after the update.Output
Upload or create a file in Slack
Upload or create a file in Slack
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
initial_comment is also provided.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.Output
Triggers
New Channel Created Trigger
New Channel Created Trigger
Channel Message Received
Channel Message Received
Direct Message Received
Direct Message Received
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
Payload
Message Reaction Added
Message Reaction Added
Message Reaction Removed
Message Reaction Removed
Reaction Added Trigger
Reaction Added Trigger
SLACKBOT_REACTION_ADDEDType: webhookDEPRECATED: use SLACK_MESSAGE_REACTION_ADDED instead.Triggered when a reaction is added to a message in Slack.Payload
Reaction Removed Trigger
Reaction Removed Trigger
SLACKBOT_REACTION_REMOVEDType: webhookDEPRECATED: use SLACK_MESSAGE_REACTION_REMOVED instead.Triggered when a reaction is removed from a message.Payload
New Bot Message Received Trigger
New Bot Message Received Trigger
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
New Message Received Trigger
New Message Received Trigger
SLACKBOT_RECEIVE_MESSAGEType: webhookDEPRECATED: use SLACK_CHANNEL_MESSAGE_RECEIVED instead.Triggered when a new message is posted to a Slack channel.