Slack | Composio Docs

Overview

SLUG

SLACK

Description

Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.

Authentication Details

OAuth2

client_id

stringRequired

client_secret

stringRequired

oauth_redirect_uri

stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add

user_scopes

stringDefaults to channels:history,chat:write,team:read,channels:read,users:read,reminders:write,reactions:read

bearer_token

string

Bearer Token

token

stringRequired

Tools

Add reaction to message

SLUG: SLACK_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.

Action Parameters

channel

stringRequired

name

stringRequired

timestamp

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create a reminder

SLUG: SLACK_CREATE_A_REMINDER

Creates 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').

Action Parameters

text

stringRequired

time

stringRequired

user

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Fetch conversation history

SLUG: SLACK_FETCH_CONVERSATION_HISTORY

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

Action Parameters

channel

string

cursor

string

inclusive

boolean

latest

integer

limit

integer

oldest

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

List conversations

SLUG: SLACK_LIST_ALL_SLACK_TEAM_CHANNELS_WITH_VARIOUS_FILTERS

Retrieves public channels, private channels, multi-person direct messages (mpims), and direct messages (ims) from a slack workspace, with options to filter by type and exclude archived channels.

Action Parameters

cursor

string

exclude_archived

boolean

limit

integerDefaults to 1

types

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

List all Slack team users with pagination

SLUG: SLACK_LIST_ALL_SLACK_TEAM_USERS_WITH_PAGINATION

Retrieves a paginated list of all users, including comprehensive details, profile information, status, and team memberships, in a slack workspace; data may not be real-time.

Action Parameters

cursor

string

include_locale

boolean

limit

integerDefaults to 1

Action Response

data

objectRequired

error

string

successful

booleanRequired

Remove reaction from item

SLUG: SLACK_REMOVE_REACTION_FROM_ITEM

Removes an emoji reaction from a message, file, or file comment in slack.

Action Parameters

channel

string

file

string

file_comment

string

name

stringRequired

timestamp

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Schedule message in chat

SLUG: SLACK_SCHEDULES_A_MESSAGE_TO_A_CHANNEL_AT_A_SPECIFIED_TIME

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.

Action Parameters

as_user

boolean

attachments

string

blocks

string

channel

string

link_names

boolean

parse

string

post_at

string

reply_broadcast

boolean

text

string

thread_ts

integer

unfurl_links

boolean

unfurl_media

boolean

Action Response

data

objectRequired

error

string

successful

booleanRequired

Search Messages

SLUG: SLACK_SEARCH_FOR_MESSAGES_WITH_QUERY

Searches messages in a slack workspace using a query with optional modifiers (e.g., `in:`, `from:`, `has:`, `before:`) across accessible channels, dms, and private groups.

Action Parameters

count

integerDefaults to 1

highlight

boolean

page

integer

query

stringRequired

sort

string

sort_dir

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Send a message to a Slack channel

SLUG: SLACK_SENDS_A_MESSAGE_TO_A_SLACK_CHANNEL

Posts a message to a slack channel, direct message, or private group; requires content via `text`, `blocks`, or `attachments`.

Action Parameters

as_user

boolean

attachments

string

blocks

string

channel

stringRequired

icon_emoji

string

icon_url

string

link_names

boolean

mrkdwn

boolean

parse

string

reply_broadcast

boolean

text

string

thread_ts

string

unfurl_links

boolean

unfurl_media

boolean

username

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Update a Slack message

SLUG: SLACK_UPDATES_A_SLACK_MESSAGE

Updates a slack message, identified by `channel` id and `ts` timestamp, by modifying its `text`, `attachments`, or `blocks`; provide at least one content field, noting `attachments`/`blocks` are replaced if included (`[]` clears them).

Action Parameters

as_user

string

attachments

string

blocks

string

channel

stringRequired

link_names

string

parse

string

text

string

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Set snooze duration

SLUG: SLACK_ACTIVATE_OR_MODIFY_DO_NOT_DISTURB_DURATION

Sets or updates the do not disturb (dnd) snooze duration in minutes for the authenticated user, pausing notifications immediately for the specified time.

Action Parameters

num_minutes

stringRequired

token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Add an emoji alias

SLUG: SLACK_ADD_AN_EMOJI_ALIAS_IN_SLACK

Adds an alias for an existing custom emoji in a slack enterprise grid organization.

Action Parameters

alias_for

stringRequired

name

stringRequired

token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Add a custom emoji to a Slack team

SLUG: SLACK_ADD_A_CUSTOM_EMOJI_TO_A_SLACK_TEAM

Adds a custom emoji to a slack workspace given a unique name and an image url; subject to workspace emoji limits.

Action Parameters

name

stringRequired

token

stringRequired

url

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Add a remote file

SLUG: SLACK_ADD_A_REMOTE_FILE_FROM_A_SERVICE

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

Action Parameters

external_id

string

external_url

string

filetype

string

indexable_file_contents

string

preview_image

string

title

string

token

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Add a star to an item

SLUG: SLACK_ADD_A_STAR_TO_AN_ITEM

Stars a channel, file, file comment, or a specific message in slack.

Action Parameters

channel

string

file

string

file_comment

string

timestamp

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Add default channels to IDP group

SLUG: SLACK_ADD_DEFAULT_CHANNELS_TO_IDP_GROUP

Adds channels to an idp user group's list of default channels, meaning new group members are automatically added to them; these channels supplement, and do not replace, any existing defaults.

Action Parameters

channel_ids

stringRequired

team_id

string

usergroup_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Add enterprise user to workspace

SLUG: SLACK_ADD_ENTERPRISE_USER_TO_WORKSPACE

Assigns an existing enterprise user, not already in the target workspace, to a specific slack workspace within an enterprise grid organization, optionally adding them to channels and defining their guest status.

Action Parameters

channel_ids

string

is_restricted

boolean

is_ultra_restricted

boolean

team_id

stringRequired

user_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Add IDP group allowlist to channel

SLUG: SLACK_ADD_IDP_GROUP_ALLOWLIST_TO_CHANNEL

Restricts access to a private slack channel to members of a specified idp group by linking the group to the channel's allowlist within an enterprise grid organization; `team id` is required for single-workspace channels, otherwise optional.

Action Parameters

channel_id

stringRequired

group_id

stringRequired

team_id

string

token

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Approve admin apps request

SLUG: SLACK_APPROVE_AN_APP_INSTALLATION_IN_A_WORKSPACE

Approves a pending app installation request within a slack workspace; requires admin privileges.

Action Parameters

app_id

string

request_id

string

team_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Approve invite request for team

SLUG: SLACK_APPROVE_WORKSPACE_INVITE_REQUEST

Approves an existing, pending invite request for a slack workspace; this action is irreversible.

Action Parameters

invite_request_id

stringRequired

team_id

string

Action Response

data

objectRequired

error

string

successful

booleanRequired