Slackbot

Overview

Slackbot gives agents workspace-wide read access to a Slack workspace on behalf of the installing user — allowing them to search messages and files, browse channel and thread history, and look up users by email. While reading as the user, it continues posting and reacting as the bot, and also supports direct messages (DMs).

• Official website: https://slack.com/
• Composio documentation: docs.composio.dev/toolkits/slackbot

Authentication

This tool uses OAuth 2.0 (OAUTH2) to connect.

You will need to authorize access to your Slack account during the connection flow hosted by Composio.

Field	Required	Description
OAuth 2.0	Yes	Authorization via Slack account on the Composio secure page.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Slackbot.
3. Click the card to open the details modal and hit Connect.
4. You’re taken to the secure connection page hosted by Composio, where you authorize access (OAuth) to your Slack account.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available for your agents. (Connection-flow details in Organization Tools.)

Available actions

Note

This integration exposes 88 actions in total. The most relevant ones are listed below; see the full list in the Composio documentation.

Send message

SLACKBOT_SEND_MESSAGE

Posts 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.

Input parameters

Name	Type	Required	Description
channel	string	Yes	ID or name of the channel, private group, or IM to send the message to. Do not include the ’#’ prefix. For DMs, use the channel ID returned by SLACKBOT_OPEN_DM.
markdown_text	string	No	Use for normal LLM-written message content. Supports Markdown: headings, bold, italic, links, lists, code, quotes, dividers, tables.
blocks	array	No	Use instead of markdown_text only when you need Slack Block Kit capabilities (buttons, menus, checkboxes, etc.).
thread_ts	string	No	Timestamp of an existing message to make this a threaded reply.
fallback_text	string	No	Only when using blocks. Fallback text for notifications and accessibility.
unfurl_links	boolean	No	Enable unfurling of text-based URLs.
unfurl_media	boolean	No	Enable media previews from URLs.
reply_broadcast	boolean	No	If true for a threaded reply, also posts to the main channel.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Fetch conversation history

SLACKBOT_FETCH_CONVERSATION_HISTORY

Fetches a chronological list of messages and events from a specified Slack conversation, with options for pagination and time range filtering. Note: only returns messages from the main channel timeline; threaded replies require SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION.

Input parameters

Name	Type	Required	Description
channel	string	Yes	ID of the public channel, private channel, DM, or multi-person DM to fetch history from.
limit	integer	No	Maximum number of messages to request in this single API call (1–1000). Defaults to 100.
cursor	string	No	Pagination cursor from response_metadata.next_cursor of a previous response.
oldest	string	No	Start of the time range. Accepts Unix or Slack timestamp.
latest	string	No	End of the time range. Accepts Unix or Slack timestamp.
inclusive	boolean	No	When true, includes messages at the exact oldest or latest boundary timestamps.
include_all_metadata	boolean	No	Return all metadata associated with messages.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Retrieve conversation replies

SLACKBOT_FETCH_MESSAGE_THREAD_FROM_A_CONVERSATION

Retrieves replies to a specific parent message in a Slack conversation, using the channel ID and the parent message’s timestamp. If the returned messages array contains fewer replies than reply_count indicates, check pagination or permissions.

Input parameters

Name	Type	Required	Description
channel	string	No	ID of the conversation to fetch the thread from. Must be a channel ID, not a channel name.
ts	string	No	Timestamp of the parent message in the thread. Must be the exact full timestamp string of the root/parent message.
limit	integer	No	Maximum number of messages to return.
cursor	string	No	Pagination cursor from response_metadata.next_cursor.
oldest	string	No	Oldest message timestamp in the time range.
latest	string	No	Latest message timestamp in the time range.
inclusive	boolean	No	Include messages with latest or oldest timestamps in results.
include_all_metadata	boolean	No	Return all metadata associated with messages in the thread.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Find channels

SLACKBOT_FIND_CHANNELS

Find channels in a Slack workspace by any criteria — name, topic, purpose, or description. Returns channel IDs (C*/G* prefixed) required by most Slack tools.

Input parameters

Name	Type	Required	Description
query	string	Yes	Search query to find channels. Searches across channel name, topic, purpose, and description (case-insensitive partial matching).
limit	integer	No	Maximum number of channels to return (1 to 999). Defaults to 50.
types	string	No	Comma-separated list of channel types: public_channel, private_channel, mpim, im.
team_id	string	No	Workspace ID when using an org-level token.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Search messages

SLACKBOT_SEARCH_MESSAGES

Workspace-wide Slack message search with date ranges and filters. Use query modifiers (e.g., in:#channel, from:@user, before/after:YYYY-MM-DD), sorting, and pagination.

Input parameters

Name	Type	Required	Description
query	string	Yes	Search query supporting various modifiers for precise filtering. E.g., "project update" on:2025-09-25 in:#marketing from:@john.
sort	string	No	Sort by score (relevance) or timestamp (chronological).
sort_dir	string	No	Sort direction: asc or desc.
count	integer	No	Number of messages per page (max 100).
cursor	string	No	Pagination cursor; use * for the first call, then next_cursor from subsequent responses.
page	integer	No	Page number for manual pagination. Cannot be used with auto_paginate.
auto_paginate	boolean	No	When enabled, count becomes the total messages desired and pagination is automatic.
highlight	boolean	No	Enable highlighting of search terms in results.
team_id	string	No	Workspace ID for search. Relevant only with an org-level token.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Search all content

SLACKBOT_SEARCH_ALL

Tool to search all messages and files. Use when you need unified content search across channels and files in one call.

Input parameters

Name	Type	Required	Description
query	string	Yes	Search query supporting Slack search modifiers/booleans.
sort	string	No	Sort by score (relevance) or timestamp (chronological).
sort_dir	string	No	Sort direction: asc or desc.
count	integer	No	Number of results per page; default is 20; max is 100.
page	integer	No	Page number of results to return; default is 1.
highlight	boolean	No	If true, search terms are wrapped with markers for client-side highlighting.
team_id	string	No	Encoded team ID to search in; required when using an org-level token.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

List all channels

SLACKBOT_LIST_ALL_CHANNELS

Lists all channels in a Slack workspace accessible to the authenticated token, with support for pagination and type filtering.

Input parameters

Name	Type	Required	Description
limit	integer	No	Maximum number of channels to return per page.
cursor	string	No	Pagination cursor for fetching specific pages of results.
types	string	No	Channel types to include: public_channel, private_channel, mpim, im.
team_id	string	No	Workspace ID when using an org-level token.
exclude_archived	boolean	No	Exclude archived channels from results.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

List all users

SLACKBOT_LIST_ALL_USERS

Lists all users in a Slack workspace. Supports pagination and team filtering.

Input parameters

Name	Type	Required	Description
limit	integer	No	Maximum number of users to return per page.
cursor	string	No	Pagination cursor from response_metadata.next_cursor.
team_id	string	No	Workspace ID when using an org-level token.
include_locale	boolean	No	Include the user’s preferred locale in the response.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Lookup users by email

SLACKBOT_LOOKUP_USERS_BY_EMAIL

Finds a Slack user by email address and returns the ID and profile data.

Input parameters

Name	Type	Required	Description
email	string	Yes	Email address of the user to look up.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Open DM

SLACKBOT_OPEN_DM

Opens or resumes a Slack direct message (DM) or multi-person direct message (MPIM) by providing either user IDs or an existing channel ID. Returns already_open=true when the DM already exists.

Input parameters

Name	Type	Required	Description
users	string	No	Comma-separated string of user IDs (1 for a DM, or 2–8 for an MPIM). Only Slack user IDs (U0123456789), not emails or display names.
channel	string	No	ID or name of an existing DM or MPIM channel to open/resume.
return_im	boolean	No	If true, returns the full DM channel object.
prevent_creation	boolean	No	Do not create a new DM or MPIM; only check if one already exists.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Create channel

SLACKBOT_CREATE_CHANNEL

Initiates a public or private channel-based conversation in a Slack workspace. Immediately creates the channel; invoke only after explicit user confirmation.

Input parameters

Name	Type	Required	Description
name	string	Yes	Name of the public or private channel to create. Must be lowercase, unique, and contain no spaces or periods; max 80 characters.
is_private	boolean	No	Create a private channel instead of a public one.
team_id	string	No	Encoded team ID to create the channel in, required if org token is used.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Invite users to a Slack channel

SLACKBOT_INVITE_USERS_TO_A_CHANNEL

Invites users to an existing Slack channel using their valid Slack User IDs. Response is always HTTP 200; inspect ok, error, and errors fields to confirm users were added.

Input parameters

Name	Type	Required	Description
channel	string	No	ID of the public or private Slack channel to invite users to. Bot must already be a member of private channels.
users	string	No	Comma-separated string of valid Slack User IDs to invite. Up to 1000 user IDs can be included.
force	boolean	No	When set to true and multiple user IDs are provided, continue inviting the valid ones while disregarding invalid IDs.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Add reaction to message

SLACKBOT_ADD_REACTION_TO_AN_ITEM

Adds a specified emoji reaction to an existing message in a Slack channel, identified by its timestamp; does not remove or retrieve reactions.

Input parameters

Name	Type	Required	Description
name	string	Yes	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.
channel	string	Yes	ID of the channel where the message to add the reaction to was posted.
timestamp	string	Yes	Timestamp of the message to which the reaction will be added. Must be the exact message timestamp.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Schedule message

SLACKBOT_SCHEDULE_MESSAGE

Schedules a message to a Slack channel, DM, or private group for a future time (post_at), requiring text, blocks, or attachments for content; scheduling is limited to 120 days in advance.

Input parameters

Name	Type	Required	Description
channel	string	No	Channel, private group, or DM channel ID or name to send the message to. Bot must be a member of the target channel.
post_at	string	No	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.
markdown_text	string	No	Preferred: write your scheduled message in markdown for nicely formatted display.
text	string	No	This sends raw text only, use markdown_text field for formatting.
thread_ts	string	No	Timestamp of the parent message for the scheduled message to be a thread reply.
blocks	string	No	Deprecated: use markdown_text instead. JSON array of structured blocks.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Update a Slack message

SLACKBOT_UPDATES_A_MESSAGE

Updates 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.

Input parameters

Name	Type	Required	Description
ts	string	Yes	Timestamp of the message to update (string, Unix time with microseconds, e.g., '1234567890.123456').
channel	string	Yes	ID or name of the channel, private group, or IM channel containing the message to update.
markdown_text	string	No	Use for normal LLM-written updated message content. Supports Slack’s native markdown handling.
blocks	array	No	Use instead of markdown_text for Slack Block Kit capabilities.
fallback_text	string	No	Only when using blocks. Fallback text for notifications and accessibility.
as_user	boolean	No	Pass true to update the message as the authenticated user.
file_ids	array	No	Array of file IDs to attach to the updated message. Files must already be uploaded to Slack.
reply_broadcast	boolean	No	If true and the message is a thread reply, broadcast the updated message to the channel.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Delete a message from a chat

SLACKBOT_DELETE_A_MESSAGE_FROM_A_CHAT

Deletes a message from a Slack channel, identified by its timestamp.

Input parameters

Name	Type	Required	Description
ts	string	Yes	Timestamp of the message to delete.
channel	string	Yes	Channel containing the message to delete.
as_user	boolean	No	Pass true to delete the message as the authed user.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Retrieve conversation information

SLACKBOT_RETRIEVE_CONVERSATION_INFORMATION

Retrieves metadata for a Slack conversation by ID (e.g., name, purpose, creation date), excluding message content.

Input parameters

Name	Type	Required	Description
channel	string	No	The ID of the conversation (channel, direct message, or MPIM) to retrieve information for. Effectively required.
include_locale	boolean	No	If true, the response will include the locale setting for the conversation.
include_num_members	boolean	No	If true, the response will include the number of members in the conversation.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Get conversation members

SLACKBOT_RETRIEVE_CONVERSATION_MEMBERS_LIST

Retrieves a paginated list of active member IDs 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

Name	Type	Required	Description
channel	string	No	ID of the conversation for which to retrieve the member list. Channel names are NOT accepted — only IDs.
limit	integer	No	The maximum number of members to return per page.
cursor	string	No	Pagination cursor. Pass next_cursor from previous calls to avoid silently truncating large member lists.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Retrieve detailed user information

SLACKBOT_RETRIEVE_DETAILED_USER_INFORMATION

Retrieves 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.

Input parameters

Name	Type	Required	Description
user	string	No	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.
include_locale	boolean	No	Set to true to include the user’s locale (e.g., en-US) in the response.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Send ephemeral message

SLACKBOT_SEND_EPHEMERAL_MESSAGE

Sends 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

Name	Type	Required	Description
user	string	Yes	User ID of the user to send the ephemeral message to.
channel	string	Yes	Channel, private group, or DM channel to send message to. Pass the channel ID (e.g., C0ABC12345).
text	string	No	The message text to display. Required unless ‘blocks’ or ‘attachments’ is provided.
markdown_text	string	No	Preferred: write your ephemeral message in markdown for nicely formatted display.
blocks	string	No	A JSON-based array of structured blocks, presented as a URL-encoded string.
thread_ts	string	No	Provide another message’s ts value to make this message a reply.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Pin an item to a channel

SLACKBOT_PIN_ITEM

Pins a message to a specified Slack channel; the message must not already be pinned.

Input parameters

Name	Type	Required	Description
channel	string	Yes	The ID of the channel where the message will be pinned.
timestamp	string	Yes	Timestamp of the message to pin, in ‘epoch_time.microseconds’ format (e.g., ‘1624464000.000200’).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Upload or create a file in Slack

SLACKBOT_UPLOAD_OR_CREATE_A_FILE_IN_SLACK

Upload 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.

Input parameters

Name	Type	Required	Description
channels	string	No	Channel ID where the file will be shared; if omitted, file is private to the uploader. Use channel ID (e.g., C1234567890) not channel name.
content	string	No	Text content of the file; use for text-based files. At least one of ‘content’ or ‘file’ must be provided (but not both).
file	string	No	File(s) to upload. At least one of ‘content’ or ‘file’ must be provided (but not both).
filename	string	No	Filename to be displayed in Slack. Required when using ‘content’ parameter.
title	string	No	Title of the file, displayed in Slack.
thread_ts	string	No	Timestamp of a parent message to upload this file as a reply.
initial_comment	string	No	Optional message to introduce the file in specified ‘channels’.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Set conversation topic

SLACKBOT_SET_THE_TOPIC_OF_A_CONVERSATION

Sets or updates the topic for a specified Slack conversation.

Input parameters

Name	Type	Required	Description
channel	string	No	The ID of the conversation for which the topic will be set. Must be a channel ID (C/G/D prefix), not a human-readable name.
topic	string	No	The new topic for the conversation. Max 250 characters. Text formatting and linkification are not supported.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Create a reminder

SLACKBOT_CREATE_A_REMINDER

Creates a reminder in Slack for the authenticated user or another user.

Input parameters

Name	Type	Required	Description
text	string	Yes	The content of the reminder.
time	string	Yes	When this reminder should happen. Accepts Unix timestamp or relative time string (e.g., in 5 minutes, at 3pm).
user	string	No	The user who will receive the reminder. Defaults to the authenticated user.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Rename a conversation

SLACKBOT_RENAME_A_CONVERSATION

Renames a Slack channel. The calling user must be a member of the channel.

Input parameters

Name	Type	Required	Description
name	string	Yes	New name for the channel. Must be lowercase, without spaces or periods.
channel	string	Yes	ID of the channel to rename.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not

Retrieve user profile information

SLACKBOT_RETRIEVE_USER_PROFILE_INFORMATION

Retrieves profile information for a specified Slack user (defaults to the authenticated user if user ID is omitted). Sensitive fields like email and phone may be silently omitted based on workspace privacy policies.

Input parameters

Name	Type	Required	Description
user	string	No	User ID to retrieve profile information for; defaults to the authenticated user.
include_labels	boolean	No	Include human-readable labels for custom profile fields.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution
error	string	No	Error if any occurred during the execution of the action
successful	boolean	Yes	Whether or not the action execution was successful or not