Slack

Reference for the Tracecat Slack integration: registered actions, required secrets, expected inputs, and example workflow usage.

Add reaction

Action ID: tools.slack.add_reaction

Add a reaction to a message in a Slack channel.

Reference: https://docs.slack.dev/reference/methods/reactions.add/

Input fields

channel · string · required

ID of the channel to add the reaction to.

name · string · required

Name of the reaction to add.

timestamp · string · required

Timestamp of the message to add the reaction to.

Append stream

Action ID: tools.slack.append_stream

Append text or chunks to an existing Slack streaming message.

Reference: https://docs.slack.dev/reference/methods/chat.appendStream/

Input fields

channel · string · required

ID of the channel containing the streaming message.

ts · string · required

Timestamp of the streaming message.

chunks · array[object] | null

Streaming chunks, such as markdown_text, task_update, plan_update, or blocks chunks.

Default: null.

markdown_text · string | null

Markdown-formatted text to append to the stream.

Default: null.

Archive channel

Action ID: tools.slack.archive_channel

Archive a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.archive/

Input fields

channel · string · required

ID of the channel to archive.

Assistant search context

Action ID: tools.slack.assistant_search_context

Search Slack messages, files, channels, and users for AI assistant context.

Reference: https://docs.slack.dev/reference/methods/assistant.search.context/

Input fields

action_token · string · required

Action token from a Slack assistant message event.

query · string · required

User prompt or search query.

after · integer | null

UNIX timestamp filter for results after this time.

Default: null.

before · integer | null

UNIX timestamp filter for results before this time.

Default: null.

channel_types · array[string]

Slack channel types to search.

Default: [ "public_channel" ].

content_types · array[string]

Slack content types to include in search results.

Default: [ "messages" ].

context_channel_id · string | null

Context channel ID to scope the search when applicable.

Default: null.

cursor · string | null

Cursor returned by Slack for the next page of results.

Default: null.

disable_semantic_search · boolean

Whether to disable semantic search and use keyword search only.

Default: false.

highlight · boolean

Whether to highlight the search query in results.

Default: false.

include_archived_channels · boolean

Whether to include archived channels in search results.

Default: false.

include_bots · boolean

Whether to include bot-authored results.

Default: false.

include_context_messages · boolean

Whether to include context messages around message results.

Default: false.

include_deleted_users · boolean

Whether to include deleted users in user search results.

Default: false.

include_message_blocks · boolean

Whether to include message blocks in the response.

Default: false.

limit · integer

Number of results to return, up to a maximum of 20.

Default: 20.

modifiers · string | null

Slack search modifiers, such as has:pin before:yesterday.

Default: null.

sort · string

Field to sort results by. Supported values are score and timestamp.

Default: "score".

sort_dir · string

Direction to sort results by. Supported values are asc and desc.

Default: "desc".

term_clauses · array[string]

Term clauses that every returned search result should match.

Default: [].

Assistant search info

Action ID: tools.slack.assistant_search_info

Return Slack assistant search capabilities for the workspace.

Reference: https://docs.slack.dev/reference/methods/assistant.search.info/

Input fields

This action does not take input fields.

Create canvas

Action ID: tools.slack.create_canvas

Create a standalone Slack canvas.

Reference: https://docs.slack.dev/reference/methods/canvases.create/

Input fields

channel_id · string | null

ID of the channel where the canvas should be tabbed.

Default: null.

document_content · object | null

Structure describing the type and value of the content to create.

Default: null.

title · string | null

Title of the newly created canvas.

Default: null.

Create channel

Action ID: tools.slack.create_channel

Create a new Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.create/

Input fields

name · string · required

Name of the channel to create.

is_private · boolean

Whether the channel is private.

Default: false.

Create channel canvas

Action ID: tools.slack.create_channel_canvas

Create a Slack channel canvas for a channel.

Reference: https://docs.slack.dev/reference/methods/conversations.canvases.create/

Input fields

channel_id · string · required

ID of the channel where the canvas will be tabbed.

document_content · object | null

Structure describing the type and value of the content to create.

Default: null.

title · string | null

Title of the newly created canvas.

Default: null.

Delete canvas

Action ID: tools.slack.delete_canvas

Delete a Slack canvas.

Reference: https://docs.slack.dev/reference/methods/canvases.delete/

Input fields

canvas_id · string · required

Encoded ID of the canvas to delete.

Delete canvas access

Action ID: tools.slack.delete_canvas_access

Remove access to a Slack canvas for specified channels or users.

Reference: https://docs.slack.dev/reference/methods/canvases.access.delete/

Input fields

canvas_id · string · required

Encoded ID of the canvas to remove access from.

channel_ids · array[string] | null

List of channels to remove access for.

Default: null.

user_ids · array[string] | null

List of users to remove access for.

Default: null.

Delete message

Action ID: tools.slack.delete_message

Delete a message from a Slack channel.

Reference: https://docs.slack.dev/reference/methods/chat.delete/

Input fields

channel · string · required

ID of the channel to delete the message from.

ts · string · required

Timestamp of the message to delete.

Edit canvas

Action ID: tools.slack.edit_canvas

Update an existing Slack canvas.

Reference: https://docs.slack.dev/reference/methods/canvases.edit/

Input fields

canvas_id · string · required

Encoded ID of the canvas to update.

changes · array[object] · required

List of changes to apply to the canvas.

Get reactions

Action ID: tools.slack.get_reactions

Get reactions to a message.

Reference: https://docs.slack.dev/reference/methods/reactions.get/

Input fields

channel · string · required

The channel to get reactions from.

timestamp · string · required

The timestamp of the message to get reactions from.

Get user profile

Action ID: tools.slack.get_profile

Get a user’s profile.

Reference: https://docs.slack.dev/reference/methods/users.profile.get/

Input fields

user · string · required

ID of the user to get the profile of.

Invite members to channel

Action ID: tools.slack.invite_members

Invite members to a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.invite/

Input fields

channel · string · required

ID of the channel to invite members to.

users · array[string] · required

List of user IDs to invite to the channel.

Kick member

Action ID: tools.slack.kick_member

Kick a member from a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.kick/

Input fields

channel · string · required

ID of the channel to kick members from.

user · string · required

ID of the user to kick from the channel.

List channels

Action ID: tools.slack.list_channels

List all channels.

Reference: https://docs.slack.dev/reference/methods/conversations.list/

Input fields

exclude_archived · boolean

Whether to exclude archived channels from the list.

Default: false.

limit · integer

Maximum number of channels to return.

Default: 100.

types · array[string]

Types of channels to return.

Default: [ "public_channel", "private_channel" ].

List conversation replies

Action ID: tools.slack.list_replies

List replies to a conversation in a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.replies/

Input fields

channel · string · required

ID of the channel to list replies from.

ts · string · required

Timestamp of the thread’s parent message or message in the thread to list replies from. Also known as thread_ts in some Slack responses.

List members

Action ID: tools.slack.list_members

List members of a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.members/

Input fields

channel · string · required

ID of the channel to list members of.

limit · integer

Maximum number of members to return.

Default: 100.

List messages

Action ID: tools.slack.list_messages

List messages from a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.history/

Input fields

channel · string · required

ID of the channel to list messages from.

inclusive · boolean

Include messages with latest or oldest timestamps in results. Ignored unless either timestamp is specified.

Default: false.

latest · string | null

Unix timestamp of the latest message to return.

Default: null.

limit · integer

Maximum number of messages to return.

Default: 100.

oldest · string | null

Unix timestamp of the oldest message to return.

Default: null.

List users

Action ID: tools.slack.list_users

List users in a Slack workspace.

Reference: https://docs.slack.dev/reference/methods/users.list/

Input fields

include_locale · boolean

Whether to include the locale in the response.

Default: false.

limit · integer

The maximum number of users to return.

Default: 100.

Lookup canvas sections

Action ID: tools.slack.lookup_canvas_sections

Find Slack canvas sections matching the provided criteria.

Reference: https://docs.slack.dev/reference/methods/canvases.sections.lookup/

Input fields

canvas_id · string · required

Encoded ID of the canvas to search.

criteria · object · required

Filtering criteria used to find matching sections.

Lookup many users by email

Action ID: tools.slack.lookup_users_by_email

Lookup users by emails. Returns a list of users found and a list of users not found.

Reference: https://docs.slack.dev/reference/methods/users.lookupByEmail/

Secrets

Required secrets:

• slack: required values SLACK_BOT_TOKEN.

Input fields

emails · array[string] · required

List of user emails.

Lookup user by email

Action ID: tools.slack.lookup_user_by_email

Get a Slack user by email.

Reference: https://docs.slack.dev/reference/methods/users.lookupByEmail/

Input fields

email · string · required

Email of an existing user.

Open view

Action ID: tools.slack.open_view

Open a view. Used to create a pop up modal.

Reference: https://docs.slack.dev/reference/methods/views.open/

Input fields

trigger_id · string · required

Trigger ID from a Slack interaction payload. See: https://docs.slack.dev/reference/interaction-payloads/block_actions-payload/

view · object · required

View payload for the modal to open. See: https://docs.slack.dev/reference/views/modal-views/

Post ephemeral message

Action ID: tools.slack.post_ephemeral

Send an ephemeral Slack message to a user in a channel.

Reference: https://docs.slack.dev/reference/methods/chat.postEphemeral/

Input fields

channel · string · required

Channel, private group, or IM channel to send the ephemeral message to.

user · string · required

ID of the user who will receive the ephemeral message.

as_user · boolean | null

Legacy option to post the message as the authenticated user.

Default: null.

attachments · array[object] | null

List of JSON-based attachments.

Default: null.

blocks · array[object] | null

List of JSON-based blocks.

Default: null.

icon_emoji · string | null

Emoji to use as the icon for this message.

Default: null.

icon_url · string | null

URL to an image to use as the icon for this message.

Default: null.

link_names · boolean

Whether Slack should find and link channel names and usernames.

Default: false.

markdown_text · string | null

Markdown-formatted message text. Do not use with blocks or text.

Default: null.

parse · string | null

How Slack should parse message text.

Default: null.

text · string | null

Message text. Used as fallback text when blocks are provided.

Default: null.

thread_ts · string | null

Parent message timestamp for posting the ephemeral message in a thread.

Default: null.

username · string | null

Bot username to display.

Default: null.

Post message

Action ID: tools.slack.post_message

Post a message to a Slack channel.

Reference: https://docs.slack.dev/reference/methods/chat.postMessage/

Input fields

channel · string · required

The channel to post the message to.

blocks · array[object] | null

List of JSON-based blocks.

Default: null.

markdown_text · string | null

The text to post to Slack, in Markdown format.

Default: null.

text · string | null

The message to post to Slack.

Default: null.

thread_ts · string | null

The timestamp of the thread to reply to.

Default: null.

unfurl_links · boolean

Whether to unfurl links in the message.

Default: true.

unfurl_media · boolean

Whether to unfurl media in the message.

Default: false.

Remove reaction

Action ID: tools.slack.remove_reaction

Remove a reaction from a message in a Slack channel.

Reference: https://docs.slack.dev/reference/methods/reactions.remove/

Input fields

channel · string · required

ID of the channel to remove the reaction from.

name · string · required

Name of the reaction to remove.

timestamp · string · required

Timestamp of the message to remove the reaction from.

Revoke sessions

Action ID: tools.slack.revoke_sessions

Revoke all sessions on all devices for a Slack user.

Reference: https://docs.slack.dev/reference/methods/admin.users.session.reset/

Input fields

user_id · string · required

ID of an existing user.

Search messages

Action ID: tools.slack.search_messages

Search for messages matching a query in a Slack workspace.

Reference: https://docs.slack.dev/reference/methods/search.messages/

Secrets

Required secrets:

• slack_oauth: OAuth token SLACK_USER_TOKEN.

Input fields

query · string · required

Search query. To search within a channel / specific user, add in:channel_name / from:<@user_id> to the query.

count · integer

Number of messages to return.

Default: 20.

cursor · string | null

For the first call send ’*’, for subsequent calls send the value of next_cursor from the previous call.

Default: null.

sort · string

Sort by score or timestamp.

Default: "score".

Allowed values: score, timestamp.

Set assistant thread status

Action ID: tools.slack.set_assistant_thread_status

Set the status for a Slack AI assistant thread.

Reference: https://docs.slack.dev/reference/methods/assistant.threads.setStatus/

Input fields

channel_id · string · required

Channel ID containing the assistant thread.

status · string · required

Status to display for the bot user. Use an empty string to clear it.

thread_ts · string · required

Message timestamp of the assistant thread.

icon_emoji · string | null

Emoji to use as the icon for this message.

Default: null.

icon_url · string | null

Image URL to use as the icon for this message.

Default: null.

loading_messages · array[string]

Loading indicator messages to rotate through, up to 10 messages.

Default: [].

username · string | null

Bot username to display.

Default: null.

Set assistant thread suggested prompts

Action ID: tools.slack.set_assistant_thread_suggested_prompts

Set suggested prompts for a Slack AI assistant thread.

Reference: https://docs.slack.dev/reference/methods/assistant.threads.setSuggestedPrompts/

Input fields

channel_id · string · required

Channel ID containing the assistant thread.

prompts · array[map[string, string]] · required

Suggested prompts, each with title and message attributes.

thread_ts · string · required

Message timestamp of the assistant thread.

title · string | null

Optional title for the suggested prompts list.

Default: null.

Set assistant thread title

Action ID: tools.slack.set_assistant_thread_title

Set the title for a Slack AI assistant thread.

Reference: https://docs.slack.dev/reference/methods/assistant.threads.setTitle/

Input fields

channel_id · string · required

Channel ID containing the assistant thread.

thread_ts · string · required

Message timestamp of the assistant thread.

title · string · required

Title to use for the assistant thread.

Set canvas access

Action ID: tools.slack.set_canvas_access

Set access to a Slack canvas for specified channels or users.

Reference: https://docs.slack.dev/reference/methods/canvases.access.set/

Input fields

access_level · string · required

Desired access level. Valid values are read, write, or owner.

canvas_id · string · required

Encoded ID of the canvas to update access for.

channel_ids · array[string] | null

List of channels to update access for. Do not provide with user_ids.

Default: null.

user_ids · array[string] | null

List of users to update access for. Do not provide with channel_ids.

Default: null.

Set channel description

Action ID: tools.slack.set_channel_description

Set the description of a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.setPurpose/

Input fields

channel · string · required

The ID of the channel to set the description for.

description · string · required

The description to set for the channel.

Set channel topic

Action ID: tools.slack.set_channel_topic

Set the topic of a Slack channel.

Reference: https://docs.slack.dev/reference/methods/conversations.setTopic/

Input fields

channel · string · required

The ID of the channel to set the topic for.

topic · string · required

The topic to set for the channel.

Start stream

Action ID: tools.slack.start_stream

Start a new Slack streaming message in a thread.

Reference: https://docs.slack.dev/reference/methods/chat.startStream/

Input fields

channel · string · required

ID of the channel, private group, or DM for the stream.

thread_ts · string · required

Parent message timestamp to reply to with the stream.

chunks · array[object] | null

Initial streaming chunks, such as markdown_text, task_update, plan_update, or blocks chunks.

Default: null.

icon_emoji · string | null

Emoji to use as the icon for this message.

Default: null.

icon_url · string | null

URL to an image to use as the icon for this message.

Default: null.

markdown_text · string | null

Initial markdown-formatted text for the stream.

Default: null.

recipient_team_id · string | null

ID of the recipient user’s team. Required by Slack when streaming to channels.

Default: null.

recipient_user_id · string | null

ID of the user receiving the stream. Required by Slack when streaming to channels.

Default: null.

task_display_mode · string | null

How task chunks are displayed. Accepts timeline, plan, or dense.

Default: null.

username · string | null

Bot username to display.

Default: null.

Stop stream

Action ID: tools.slack.stop_stream

Stop and finalize a Slack streaming message.

Reference: https://docs.slack.dev/reference/methods/chat.stopStream/

Input fields

channel · string · required

ID of the channel containing the streaming message.

ts · string · required

Timestamp of the streaming message.

blocks · array[object] | null

Blocks rendered at the bottom of the finalized message.

Default: null.

chunks · array[object] | null

Final streaming chunks, such as markdown_text, task_update, plan_update, or blocks chunks.

Default: null.

markdown_text · string | null

Final markdown-formatted text to append before stopping the stream.

Default: null.

metadata · object | null

Slack message metadata with event_type and event_payload fields.

Default: null.

Update message

Action ID: tools.slack.update_message

Update a message in a Slack channel.

Reference: https://docs.slack.dev/reference/methods/chat.update/

Input fields

channel · string · required

ID of the channel to update the message in.

ts · string · required

Timestamp of the message to update.

blocks · array[object] | null

List of JSON-based blocks.

Default: null.

markdown_text · string | null

The text to update the message with, in Markdown format.

Default: null.

text · string | null

New text for the message.

Default: null.

Update view

Action ID: tools.slack.update_view

Update a view. Used to update a pop up modal.

Reference: https://docs.slack.dev/reference/methods/views.update/

Input fields

view · object · required

Updated view payload for the modal. See: https://docs.slack.dev/reference/views/modal-views/

view_id · string · required

ID of the view to update.

hash · string | null

Optional view state hash for optimistic concurrency control. Obtained from the response of views.open or a previous views.update. If provided, the update fails with hash_conflict when the view has been modified since. Omit to update unconditionally.

Default: null.