Use Slack to send and manage messages, work with canvases, and inspect channels and users. Custom bots also support Agent Sessions and streamed trigger responses.
Custom-bot Slack triggers can stream workflow outputs directly back into the conversation that started a run. Enable Stream response to Slack on a Message, App Mention, or Assistant Thread Started trigger, then select the outputs to deliver.
- A selected Agent output streams immediately as it is generated. If the Agent later calls a tool, any pre-tool commentary already streamed remains visible.
- A selected non-streaming block output is sent when that block invocation completes.
- Loop and parallel invocations each create their own Slack response.
- The response status label defaults to
Running and can be customized in the trigger's advanced settings.
- Optional thinking and tool-call updates appear as Slack tasks in a timeline or plan.
- Slack Agent Sessions remain in processing state for the run, return to active when it finishes, and the native Slack stop button cancels active workflow executions.
Automatic trigger responses require a custom bot created by the Slack setup wizard. They are not available with the shared Studio Slack app.
Studio workflows may use AI models to generate messages and responses sent to Slack. AI-generated content may be inaccurate or contain errors. Always review automated outputs, especially for critical communications.
For help with the Slack integration, contact help@seeyu.ai.
Integrate Slack messaging and administration into a workflow. Custom Slack bots can manage Agent Sessions, stream incremental Markdown or structured chunks, react to Agent Session events, and configure Agent View suggested prompts. Standard messaging and management operations support both the Studio app and custom bot credentials.
Send messages to Slack channels or direct messages. Supports Slack mrkdwn formatting.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
destinationType | string | No | Destination type: channel or dm |
botToken | string | No | Bot token for Custom Bot |
channel | string | No | Slack channel ID (e.g., C1234567890) |
dmUserId | string | No | Slack user ID for direct messages (e.g., U1234567890) |
text | string | Yes | Message text to send (supports Slack mrkdwn formatting) |
threadTs | string | No | Thread timestamp to reply to (creates thread reply) |
blocks | json | No | Block Kit layout blocks as a JSON array. When provided, text becomes the fallback notification text. |
files | file[] | No | Files to attach to the message |
| Parameter | Type | Description |
|---|
message | object | Complete message object with all properties returned by Slack |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
ts | string | Message timestamp |
channel | string | Channel ID where message was sent |
fileCount | number | Number of files uploaded (when files are attached) |
files | file[] | Files attached to the message |
Send an ephemeral message visible only to a specific user in a channel. Optionally reply in a thread. The message does not persist across sessions.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Slack channel ID (e.g., C1234567890) |
user | string | Yes | User ID who will see the ephemeral message (e.g., U1234567890). Must be a member of the channel. |
text | string | Yes | Message text to send (supports Slack mrkdwn formatting) |
threadTs | string | No | Thread timestamp to reply in. When provided, the ephemeral message appears as a thread reply. |
blocks | json | No | Block Kit layout blocks as a JSON array. When provided, text becomes the fallback notification text. |
| Parameter | Type | Description |
|---|
messageTs | string | Timestamp of the ephemeral message (cannot be used with chat.update) |
channel | string | Channel ID where the ephemeral message was sent |
Create and share Slack canvases in channels. Canvases are collaborative documents within Slack.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Slack channel ID (e.g., C1234567890) |
title | string | Yes | Title of the canvas |
content | string | Yes | Canvas content in markdown format |
| Parameter | Type | Description |
|---|
canvas_id | string | Unique canvas identifier |
Read the latest messages from Slack channels. Retrieve conversation history with filtering options.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
destinationType | string | No | Destination type: channel or dm |
botToken | string | No | Bot token for Custom Bot |
channel | string | No | Slack channel ID to read messages from (e.g., C1234567890) |
dmUserId | string | No | Slack user ID for DM conversation (e.g., U1234567890) |
limit | number | No | Number of messages to retrieve (default: 10, max: 15) |
oldest | string | No | Start of time range (timestamp) |
latest | string | No | End of time range (timestamp) |
| Parameter | Type | Description |
|---|
messages | array | Array of message objects from the channel |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
Retrieve a specific message by its timestamp. Useful for getting a thread parent message.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Slack channel ID (e.g., C1234567890) |
timestamp | string | Yes | Message timestamp to retrieve (e.g., 1405894322.002768) |
| Parameter | Type | Description |
|---|
message | object | The retrieved message object |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
Retrieve an entire thread including the parent message and all replies. Useful for getting full conversation context.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Slack channel ID (e.g., C1234567890) |
threadTs | string | Yes | Thread timestamp (thread_ts) to retrieve (e.g., 1405894322.002768) |
limit | number | No | Maximum number of messages to return (default: 100, max: 200) |
| Parameter | Type | Description |
|---|
parentMessage | object | The thread parent message |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
replies | array | Array of reply messages in the thread (excluding the parent) |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
messages | array | All messages in the thread (parent + replies) in chronological order |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
replyCount | number | Number of replies returned in this response |
hasMore | boolean | Whether there are more messages in the thread (pagination needed) |
Fetch every message in a Slack thread, automatically following pagination across all pages. Returns the parent message and the full set of replies.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Slack channel ID containing the thread (e.g., C1234567890) |
threadTs | string | Yes | Thread timestamp (thread_ts) of the parent message (e.g., 1405894322.002768) |
oldest | string | No | Only include replies after this Unix timestamp (seconds) |
latest | string | No | Only include replies before this Unix timestamp (seconds) |
inclusive | boolean | No | Include messages with timestamps matching oldest or latest (default: false) |
limit | number | No | Messages to request per page (default: 200, max: 999) |
cursor | string | No | Pagination cursor from a previous response.nextCursor to resume from |
maxPages | number | No | Maximum number of pages to fetch before stopping (default: 10) |
| Parameter | Type | Description |
|---|
parentMessage | object | The thread parent message, or null if the thread is empty |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
replies | array | All reply messages in the thread (excluding the parent) |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
messages | array | All messages (parent + replies) in chronological order |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
replyCount | number | Number of replies returned (excluding the parent) |
hasMore | boolean | Whether more pages remain beyond the fetched window |
nextCursor | string | Cursor to fetch the next page; null when there are no more pages |
pages | number | Number of pages fetched in this invocation |
Fetch message history from a Slack channel, automatically following pagination. Optionally filter by a time range to scrape messages since a given timestamp.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Slack channel ID (e.g., C1234567890) |
oldest | string | No | Only include messages after this Unix timestamp (seconds, e.g., 1700000000) |
latest | string | No | Only include messages before this Unix timestamp (seconds) |
inclusive | boolean | No | Include messages with timestamps matching oldest or latest (default: false) |
limit | number | No | Messages to request per page (default: 200, max: 999) |
cursor | string | No | Pagination cursor from a previous response.nextCursor to resume from |
maxPages | number | No | Maximum number of pages to fetch before stopping (default: 10) |
| Parameter | Type | Description |
|---|
messages | array | Channel messages in reverse-chronological order (newest first) |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
count | number | Total number of messages returned across all fetched pages |
hasMore | boolean | Whether more pages remain beyond the fetched window |
nextCursor | string | Cursor to fetch the next page; null when there are no more pages |
pages | number | Number of pages fetched in this invocation |
Get a stable permalink URL to a specific Slack message.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID containing the message (e.g., C1234567890) |
messageTs | string | Yes | The message's ts value (e.g., 1405894322.002768) |
| Parameter | Type | Description |
|---|
ok | boolean | Whether the permalink was retrieved successfully |
channel | string | Channel ID containing the message |
permalink | string | The permalink URL to the message |
Set or clear the assistant thread status indicator (the loading shimmer) on a Slack AI app thread. Pass an empty status to clear it.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID containing the assistant thread (e.g., C1234567890 or D1234567890) |
threadTs | string | Yes | Thread timestamp (thread_ts) of the assistant thread (e.g., 1405894322.002768) |
status | string | No | Status text to display, e.g. 'Working on it…'. Omit or pass an empty string to clear the status. |
loadingMessages | json | No | Optional list of messages to rotate through as an animated loading indicator (max 10). |
| Parameter | Type | Description |
|---|
ok | boolean | Whether the status was set successfully |
channel | string | Channel ID the status was set on |
threadTs | string | Thread timestamp the status was set on |
Set the title of a Slack assistant thread (shown in the AI app thread header).
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID containing the assistant thread (e.g., C1234567890 or D1234567890) |
threadTs | string | Yes | Thread timestamp (thread_ts) of the assistant thread (e.g., 1405894322.002768) |
title | string | Yes | The title to display for the assistant thread |
| Parameter | Type | Description |
|---|
ok | boolean | Whether the title was set successfully |
channel | string | Channel ID the title was set on |
threadTs | string | Thread timestamp the title was set on |
Set the clickable suggested prompts shown in a Slack assistant thread (the prompt chips in an AI app).
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID containing the assistant thread (e.g., C1234567890 or D1234567890) |
threadTs | string | Yes | Thread timestamp (thread_ts) of the assistant thread (e.g., 1405894322.002768) |
prompts | json | Yes | Array of prompts, each with a "title" (shown on the chip) and a "message" (sent when clicked). Max 4. |
promptsTitle | string | No | Optional heading for the prompt list, e.g. 'Suggested Prompts' |
| Parameter | Type | Description |
|---|
ok | boolean | Whether the suggested prompts were set successfully |
channel | string | Channel ID the prompts were set on |
threadTs | string | Thread timestamp the prompts were set on |
Set suggested prompts in Slack Agent View, optionally scoped to a specific thread.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Slack authentication method |
botToken | string | No | Custom Slack bot token |
channel | string | Yes | Agent direct-message channel ID |
threadTs | string | No | Optional thread timestamp for legacy thread-scoped prompts |
prompts | json | Yes | One to four prompt objects with title and message fields |
promptsTitle | string | No | Optional heading displayed above the prompt chips |
| Parameter | Type | Description |
|---|
ok | boolean | Whether Slack updated the suggested prompts |
Create or update the state of a Slack agent session associated with a thread.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Slack authentication method |
botToken | string | No | Custom Slack bot token |
channel | string | Yes | Channel ID containing the agent session thread |
threadTs | string | Yes | Timestamp of the thread associated with the agent session |
status | string | Yes | Agent session state: active, processing, suspended, or closed |
title | string | No | Title used when creating the agent session, up to 200 characters |
initiatorUserId | string | No | Slack user ID that initiated the session |
iconEmoji | string | No | Emoji used to customize the agent identity |
iconUrl | string | No | Image URL used to customize the agent identity |
username | string | No | Display name used to customize the agent identity |
| Parameter | Type | Description |
|---|
ok | boolean | Whether Slack updated the agent session |
status | string | Requested agent session status |
agentStatus | string | Agent status recorded by Slack |
title | string | Current agent session title, or null when the session has no title |
Rename the Slack agent session associated with a thread.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Slack authentication method |
botToken | string | No | Custom Slack bot token |
channel | string | Yes | Channel ID containing the agent session thread |
threadTs | string | Yes | Timestamp of the thread associated with the agent session |
title | string | Yes | New agent session title, from 1 to 200 characters |
| Parameter | Type | Description |
|---|
ok | boolean | Whether Slack renamed the agent session |
title | string | Updated agent session title |
List one page of accessible public and private Slack channels. Pass the returned nextCursor as cursor to fetch the next page.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
includePrivate | boolean | No | Include private channels the connected account can access (default: true) |
excludeArchived | boolean | No | Exclude archived channels (default: true) |
limit | number | No | Conversations to request per Slack page (default: 100, max: 200) |
cursor | string | No | Pagination cursor from a previous response.nextCursor to resume from |
| Parameter | Type | Description |
|---|
channels | array | One page of accessible public and private channels |
↳ id | string | Conversation ID (for example, C123, D123, or G123) |
↳ name | string | Channel or group-DM name; omitted for one-to-one direct messages |
↳ is_channel | boolean | Whether this is a channel |
↳ is_private | boolean | Whether the conversation is private |
↳ is_archived | boolean | Whether the conversation is archived |
↳ is_general | boolean | Whether this is the general channel |
↳ is_member | boolean | Whether the credential owner is a member |
↳ is_shared | boolean | Whether channel is shared across workspaces |
↳ is_ext_shared | boolean | Whether channel is externally shared |
↳ is_org_shared | boolean | Whether channel is org-wide shared |
↳ num_members | number | Number of members in the channel |
↳ topic | string | Conversation topic |
↳ purpose | string | Conversation purpose |
↳ created | number | Unix timestamp when channel was created |
↳ creator | string | User ID of channel creator |
↳ updated | number | Unix timestamp of last update |
↳ is_group | boolean | Whether this is a legacy private channel or group direct message |
↳ is_im | boolean | Whether this is a one-to-one direct message |
↳ is_mpim | boolean | Whether this is a group direct message |
↳ user | string | Other participant user ID for a one-to-one direct message |
↳ is_user_deleted | boolean | Whether the other participant in a direct message is deactivated |
↳ is_open | boolean | Whether a direct or group-direct-message conversation is open |
↳ priority | number | Slack sidebar sort priority |
ids | array | Conversation IDs for every returned channel |
names | array | Names of returned channels |
count | number | Number of conversations returned in this page |
hasMore | boolean | Whether a next cursor is available to fetch more Slack conversations |
nextCursor | string | Cursor to fetch the next page; null when there are no more pages |
List all members (user IDs) in a Slack channel. Use with Get User Info to resolve IDs to names.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID to list members from |
limit | number | No | Maximum number of members to return (default: 100, max: 200) |
cursor | string | No | Pagination cursor from a previous response.next_cursor |
| Parameter | Type | Description |
|---|
members | array | Array of user IDs who are members of the channel (e.g., U1234567890) |
count | number | Total number of members returned |
nextCursor | string | Cursor for the next page; null if no more pages |
List all users in a Slack workspace. Returns user profiles with names and avatars.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
includeDeleted | boolean | No | Include deactivated/deleted users (default: false) |
limit | number | No | Maximum number of users to return (default: 100, max: 200) |
cursor | string | No | Pagination cursor from a previous response.next_cursor |
| Parameter | Type | Description |
|---|
users | array | Array of user objects from the workspace |
↳ id | string | User ID (e.g., U1234567890) |
↳ name | string | Username (handle) |
↳ real_name | string | Full real name |
↳ display_name | string | Display name shown in Slack |
↳ email | string | Email address (requires users:read.email scope) |
↳ is_bot | boolean | Whether the user is a bot |
↳ is_admin | boolean | Whether the user is a workspace admin |
↳ is_owner | boolean | Whether the user is the workspace owner |
↳ deleted | boolean | Whether the user is deactivated |
↳ timezone | string | User timezone identifier |
↳ avatar | string | URL to user avatar image |
↳ status_text | string | Custom status text |
↳ status_emoji | string | Custom status emoji |
ids | array | Array of user IDs for easy access |
names | array | Array of usernames for easy access |
count | number | Total number of users returned |
nextCursor | string | Cursor for the next page; null if no more pages |
Get detailed information about a specific Slack user by their user ID.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
userId | string | Yes | User ID to look up (e.g., U1234567890) |
| Parameter | Type | Description |
|---|
user | object | Detailed user information |
↳ id | string | User ID (e.g., U1234567890) |
↳ team_id | string | Workspace/team ID |
↳ name | string | Username (handle) |
↳ real_name | string | Full real name |
↳ display_name | string | Display name shown in Slack |
↳ first_name | string | First name |
↳ last_name | string | Last name |
↳ title | string | Job title |
↳ phone | string | Phone number |
↳ skype | string | Skype handle |
↳ email | string | Email address (requires users:read.email scope) |
↳ is_bot | boolean | Whether the user is a bot |
↳ is_admin | boolean | Whether the user is a workspace admin |
↳ is_owner | boolean | Whether the user is the workspace owner |
↳ is_primary_owner | boolean | Whether the user is the primary owner |
↳ is_restricted | boolean | Whether the user is a guest (restricted) |
↳ is_ultra_restricted | boolean | Whether the user is a single-channel guest |
↳ is_app_user | boolean | Whether user is an app user |
↳ deleted | boolean | Whether the user is deactivated |
↳ color | string | User color for display |
↳ timezone | string | Timezone identifier (e.g., America/Los_Angeles) |
↳ timezone_label | string | Human-readable timezone label |
↳ timezone_offset | number | Timezone offset in seconds from UTC |
↳ avatar | string | URL to user avatar image |
↳ avatar_24 | string | URL to 24px avatar |
↳ avatar_48 | string | URL to 48px avatar |
↳ avatar_72 | string | URL to 72px avatar |
↳ avatar_192 | string | URL to 192px avatar |
↳ avatar_512 | string | URL to 512px avatar |
↳ status_text | string | Custom status text |
↳ status_emoji | string | Custom status emoji |
↳ status_expiration | number | Unix timestamp when status expires |
↳ updated | number | Unix timestamp of last profile update |
↳ has_2fa | boolean | Whether two-factor auth is enabled |
Download a file from Slack
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
fileId | string | Yes | The ID of the file to download |
fileName | string | No | Optional filename override |
| Parameter | Type | Description |
|---|
file | file | Downloaded file stored in execution files |
Update a message previously sent by the bot in Slack
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID where the message was posted (e.g., C1234567890) |
timestamp | string | Yes | Timestamp of the message to update (e.g., 1405894322.002768) |
text | string | Yes | New message text (supports Slack mrkdwn formatting) |
blocks | json | No | Block Kit layout blocks as a JSON array. When provided, text becomes the fallback notification text. |
| Parameter | Type | Description |
|---|
message | object | Complete updated message object with all properties returned by Slack |
↳ type | string | Message type (usually "message") |
↳ ts | string | Message timestamp (unique identifier) |
↳ text | string | Message text content |
↳ user | string | User ID who sent the message |
↳ bot_id | string | Bot ID if sent by a bot |
↳ username | string | Display username |
↳ channel | string | Channel ID |
↳ team | string | Team/workspace ID |
↳ thread_ts | string | Parent message timestamp (for threaded replies) |
↳ parent_user_id | string | User ID of thread parent message author |
↳ reply_count | number | Total number of replies in thread |
↳ reply_users_count | number | Number of unique users who replied |
↳ latest_reply | string | Timestamp of most recent reply |
↳ subscribed | boolean | Whether user is subscribed to thread |
↳ last_read | string | Timestamp of last read message |
↳ unread_count | number | Number of unread messages in thread |
↳ subtype | string | Message subtype (bot_message, file_share, etc.) |
↳ is_starred | boolean | Whether message is starred by user |
↳ pinned_to | array | Channel IDs where message is pinned |
↳ permalink | string | Permanent URL to the message |
↳ reactions | array | Reactions on this message |
↳ name | string | Emoji name (without colons) |
↳ count | number | Number of times this reaction was added |
↳ users | array | Array of user IDs who reacted |
↳ files | array | Files attached to the message |
↳ id | string | Unique file identifier |
↳ name | string | File name |
↳ mimetype | string | MIME type of the file |
↳ size | number | File size in bytes |
↳ url_private | string | Private download URL (requires auth) |
↳ permalink | string | Permanent link to the file |
↳ mode | string | File mode (hosted, external, etc.) |
↳ attachments | array | Legacy attachments on the message |
↳ id | number | Attachment ID |
↳ fallback | string | Plain text summary |
↳ text | string | Main attachment text |
↳ pretext | string | Text shown before attachment |
↳ color | string | Color bar hex code or preset |
↳ author_name | string | Author display name |
↳ author_link | string | Author link URL |
↳ author_icon | string | Author icon URL |
↳ title | string | Attachment title |
↳ title_link | string | Title link URL |
↳ image_url | string | Image URL |
↳ thumb_url | string | Thumbnail URL |
↳ footer | string | Footer text |
↳ footer_icon | string | Footer icon URL |
↳ ts | string | Timestamp shown in footer |
↳ blocks | array | Block Kit blocks in the message |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ edited | object | Edit information if message was edited |
↳ user | string | User ID who edited the message |
↳ ts | string | Timestamp of the edit |
content | string | Success message |
metadata | object | Updated message metadata |
↳ channel | string | Channel ID |
↳ timestamp | string | Message timestamp |
↳ text | string | Updated message text |
Delete a message previously sent by the bot in Slack
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID where the message was posted (e.g., C1234567890) |
timestamp | string | Yes | Timestamp of the message to delete (e.g., 1405894322.002768) |
| Parameter | Type | Description |
|---|
content | string | Success message |
metadata | object | Deleted message metadata |
↳ channel | string | Channel ID |
↳ timestamp | string | Message timestamp |
Add an emoji reaction to a Slack message
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID where the message was posted (e.g., C1234567890) |
timestamp | string | Yes | Timestamp of the message to react to (e.g., 1405894322.002768) |
name | string | Yes | Name of the emoji reaction (without colons, e.g., thumbsup, heart, eyes) |
| Parameter | Type | Description |
|---|
content | string | Success message |
metadata | object | Reaction metadata |
↳ channel | string | Channel ID |
↳ timestamp | string | Message timestamp |
↳ reaction | string | Emoji reaction name |
Remove an emoji reaction from a Slack message
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID where the message was posted (e.g., C1234567890) |
timestamp | string | Yes | Timestamp of the message to remove reaction from (e.g., 1405894322.002768) |
name | string | Yes | Name of the emoji reaction to remove (without colons, e.g., thumbsup, heart, eyes) |
| Parameter | Type | Description |
|---|
content | string | Success message |
metadata | object | Reaction metadata |
↳ channel | string | Channel ID |
↳ timestamp | string | Message timestamp |
↳ reaction | string | Emoji reaction name |
Get detailed information about a Slack channel by its ID
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID to get information about (e.g., C1234567890) |
includeNumMembers | boolean | No | Whether to include the member count in the response |
| Parameter | Type | Description |
|---|
channelInfo | object | Detailed channel information |
↳ id | string | Channel ID (e.g., C1234567890) |
↳ name | string | Channel name without # prefix |
↳ is_channel | boolean | Whether this is a channel |
↳ is_private | boolean | Whether channel is private |
↳ is_archived | boolean | Whether channel is archived |
↳ is_general | boolean | Whether this is the general channel |
↳ is_member | boolean | Whether the bot/user is a member |
↳ is_shared | boolean | Whether channel is shared across workspaces |
↳ is_ext_shared | boolean | Whether channel is externally shared |
↳ is_org_shared | boolean | Whether channel is org-wide shared |
↳ num_members | number | Number of members in the channel |
↳ topic | string | Channel topic |
↳ purpose | string | Channel purpose/description |
↳ created | number | Unix timestamp when channel was created |
↳ creator | string | User ID of channel creator |
↳ updated | number | Unix timestamp of last update |
Check whether a Slack user is currently active or away
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
userId | string | Yes | User ID to check presence for (e.g., U1234567890) |
| Parameter | Type | Description |
|---|
presence | string | User presence status: "active" or "away" |
online | boolean | Whether user has an active client connection (only available when checking own presence) |
autoAway | boolean | Whether user was automatically set to away due to inactivity (only available when checking own presence) |
manualAway | boolean | Whether user manually set themselves as away (only available when checking own presence) |
connectionCount | number | Total number of active connections for the user (only available when checking own presence) |
lastActivity | number | Unix timestamp of last detected activity (only available when checking own presence) |
Edit an existing Slack canvas by inserting, replacing, or deleting content
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
canvasId | string | Yes | Canvas ID to edit (e.g., F1234ABCD) |
operation | string | Yes | Edit operation: insert_at_start, insert_at_end, insert_after, insert_before, replace, delete, or rename |
content | string | No | Markdown content for the operation (required for insert/replace operations) |
sectionId | string | No | Section ID to target (required for insert_after, insert_before, replace, and delete) |
title | string | No | New title for the canvas (only used with rename operation) |
| Parameter | Type | Description |
|---|
content | string | Success message |
Create a canvas pinned to a Slack channel as its resource hub
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID to create the canvas in (e.g., C1234567890) |
title | string | No | Title for the channel canvas |
content | string | No | Canvas content in markdown format |
| Parameter | Type | Description |
|---|
canvas_id | string | ID of the created channel canvas |
Get Slack canvas file metadata by canvas ID
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
canvasId | string | Yes | Canvas file ID to retrieve (e.g., F1234ABCD) |
| Parameter | Type | Description |
|---|
canvas | object | Canvas file information returned by Slack |
↳ id | string | Unique canvas file identifier |
↳ created | number | Unix timestamp when the canvas was created |
↳ timestamp | number | Unix timestamp associated with the canvas |
↳ name | string | Canvas file name |
↳ title | string | Canvas title |
↳ mimetype | string | MIME type of the canvas file |
↳ filetype | string | Slack file type for the canvas |
↳ pretty_type | string | Human-readable file type |
↳ user | string | User ID of the canvas creator |
↳ editable | boolean | Whether the canvas file is editable |
↳ size | number | Canvas file size in bytes |
↳ mode | string | File mode |
↳ is_external | boolean | Whether the canvas is externally hosted |
↳ is_public | boolean | Whether the canvas is public |
↳ url_private | string | Private URL for the canvas file |
↳ url_private_download | string | Private download URL for the canvas file |
↳ permalink | string | Permanent URL for the canvas |
↳ channels | array | Public channel IDs where the canvas appears |
↳ groups | array | Private channel IDs where the canvas appears |
↳ ims | array | Direct message IDs where the canvas appears |
↳ canvas_readtime | number | Approximate read time for canvas content |
↳ is_channel_space | boolean | Whether this canvas is linked to a channel |
↳ linked_channel_id | string | Channel ID linked to this canvas |
↳ canvas_creator_id | string | User ID of the canvas creator |
List Slack canvases available to the authenticated user or bot
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | No | Filter canvases appearing in a specific channel ID |
count | number | No | Number of canvases to return per page |
page | number | No | Page number to return |
user | string | No | Filter canvases created by a single user ID |
tsFrom | string | No | Filter canvases created after this Unix timestamp |
tsTo | string | No | Filter canvases created before this Unix timestamp |
teamId | string | No | Encoded team ID, required when using an org-level token |
| Parameter | Type | Description |
|---|
canvases | array | Canvas file objects returned by Slack |
↳ id | string | Unique canvas file identifier |
↳ created | number | Unix timestamp when the canvas was created |
↳ timestamp | number | Unix timestamp associated with the canvas |
↳ name | string | Canvas file name |
↳ title | string | Canvas title |
↳ mimetype | string | MIME type of the canvas file |
↳ filetype | string | Slack file type for the canvas |
↳ pretty_type | string | Human-readable file type |
↳ user | string | User ID of the canvas creator |
↳ editable | boolean | Whether the canvas file is editable |
↳ size | number | Canvas file size in bytes |
↳ mode | string | File mode |
↳ is_external | boolean | Whether the canvas is externally hosted |
↳ is_public | boolean | Whether the canvas is public |
↳ url_private | string | Private URL for the canvas file |
↳ url_private_download | string | Private download URL for the canvas file |
↳ permalink | string | Permanent URL for the canvas |
↳ channels | array | Public channel IDs where the canvas appears |
↳ groups | array | Private channel IDs where the canvas appears |
↳ ims | array | Direct message IDs where the canvas appears |
↳ canvas_readtime | number | Approximate read time for canvas content |
↳ is_channel_space | boolean | Whether this canvas is linked to a channel |
↳ linked_channel_id | string | Channel ID linked to this canvas |
↳ canvas_creator_id | string | User ID of the canvas creator |
paging | object | Pagination information from Slack |
↳ count | number | Number of items requested per page |
↳ total | number | Total number of matching files |
↳ page | number | Current page number |
↳ pages | number | Total number of pages |
Find Slack canvas section IDs matching criteria for later edits
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
canvasId | string | Yes | Canvas ID to search (e.g., F1234ABCD) |
criteria | json | Yes | Section lookup criteria, such as {"section_types":["h1"],"contains_text":"Roadmap"} |
| Parameter | Type | Description |
|---|
sections | array | Canvas sections matching the lookup criteria |
↳ id | string | Canvas section identifier |
Delete a Slack canvas by its canvas ID
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
canvasId | string | Yes | Canvas ID to delete (e.g., F1234ABCD) |
| Parameter | Type | Description |
|---|
ok | boolean | Whether Slack deleted the canvas successfully |
Create a new public or private channel in a Slack workspace.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
name | string | Yes | Name of the channel to create (lowercase, numbers, hyphens, underscores only; max 80 characters) |
isPrivate | boolean | No | Create a private channel instead of a public one (default: false) |
teamId | string | No | Encoded team ID to create the channel in (required if using an org token) |
| Parameter | Type | Description |
|---|
channelInfo | object | The newly created channel object |
↳ id | string | Channel ID (e.g., C1234567890) |
↳ name | string | Channel name without # prefix |
↳ is_channel | boolean | Whether this is a channel |
↳ is_private | boolean | Whether channel is private |
↳ is_archived | boolean | Whether channel is archived |
↳ is_general | boolean | Whether this is the general channel |
↳ is_member | boolean | Whether the bot/user is a member |
↳ is_shared | boolean | Whether channel is shared across workspaces |
↳ is_ext_shared | boolean | Whether channel is externally shared |
↳ is_org_shared | boolean | Whether channel is org-wide shared |
↳ num_members | number | Number of members in the channel |
↳ topic | string | Channel topic |
↳ purpose | string | Channel purpose/description |
↳ created | number | Unix timestamp when channel was created |
↳ creator | string | User ID of channel creator |
↳ updated | number | Unix timestamp of last update |
Invite one or more users to a Slack channel. Supports up to 100 users at a time.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | The ID of the channel to invite users to |
users | string | Yes | Comma-separated list of user IDs to invite (up to 100) |
force | boolean | No | When true, continues inviting valid users while skipping invalid ones (default: false) |
| Parameter | Type | Description |
|---|
channelInfo | object | The channel object after inviting users |
↳ id | string | Channel ID (e.g., C1234567890) |
↳ name | string | Channel name without # prefix |
↳ is_channel | boolean | Whether this is a channel |
↳ is_private | boolean | Whether channel is private |
↳ is_archived | boolean | Whether channel is archived |
↳ is_general | boolean | Whether this is the general channel |
↳ is_member | boolean | Whether the bot/user is a member |
↳ is_shared | boolean | Whether channel is shared across workspaces |
↳ is_ext_shared | boolean | Whether channel is externally shared |
↳ is_org_shared | boolean | Whether channel is org-wide shared |
↳ num_members | number | Number of members in the channel |
↳ topic | string | Channel topic |
↳ purpose | string | Channel purpose/description |
↳ created | number | Unix timestamp when channel was created |
↳ creator | string | User ID of channel creator |
↳ updated | number | Unix timestamp of last update |
errors | array | Per-user errors when force is true and some invitations failed |
↳ user | string | User ID that failed |
↳ ok | boolean | Always false for error entries |
↳ error | string | Error code for this user |
Open a modal view in Slack using a trigger_id from an interaction payload. Used to display forms, confirmations, and other interactive modals.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
triggerId | string | Yes | Exchange a trigger to post to the user. Obtained from an interaction payload (e.g., slash command, button click) |
interactivityPointer | string | No | Alternative to trigger_id for posting to user |
view | json | Yes | A view payload object defining the modal. Must include type ("modal"), title, and blocks array |
| Parameter | Type | Description |
|---|
view | object | The opened modal view object |
↳ id | string | Unique view identifier |
↳ team_id | string | Workspace/team ID |
↳ type | string | View type (e.g., "modal") |
↳ title | json | Plain text title object with type and text fields |
↳ type | string | Text object type (plain_text) |
↳ text | string | Title text content |
↳ submit | json | Plain text submit button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Submit button text |
↳ close | json | Plain text close button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Close button text |
↳ blocks | array | Block Kit blocks in the view |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ private_metadata | string | Private metadata string passed with the view |
↳ callback_id | string | Custom identifier for the view |
↳ external_id | string | Custom external identifier (max 255 chars, unique per workspace) |
↳ state | json | Current state of the view with input values |
↳ hash | string | View version hash for updates |
↳ clear_on_close | boolean | Whether to clear all views in the stack when this view is closed |
↳ notify_on_close | boolean | Whether to send a view_closed event when this view is closed |
↳ root_view_id | string | ID of the root view in the view stack |
↳ previous_view_id | string | ID of the previous view in the view stack |
↳ app_id | string | Application identifier |
↳ bot_id | string | Bot identifier |
Update an existing modal view in Slack. Identify the view by view_id or external_id, and provide the updated view payload.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
viewId | string | No | Unique identifier of the view to update. Either viewId or externalId is required |
externalId | string | No | Developer-set unique identifier of the view to update (max 255 chars). Either viewId or externalId is required |
hash | string | No | View state hash to protect against race conditions. Obtained from a previous views response |
view | json | Yes | A view payload object defining the updated modal. Must include type ("modal"), title, and blocks array. Use identical block_id and action_id values to preserve input data |
| Parameter | Type | Description |
|---|
view | object | The updated modal view object |
↳ id | string | Unique view identifier |
↳ team_id | string | Workspace/team ID |
↳ type | string | View type (e.g., "modal") |
↳ title | json | Plain text title object with type and text fields |
↳ type | string | Text object type (plain_text) |
↳ text | string | Title text content |
↳ submit | json | Plain text submit button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Submit button text |
↳ close | json | Plain text close button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Close button text |
↳ blocks | array | Block Kit blocks in the view |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ private_metadata | string | Private metadata string passed with the view |
↳ callback_id | string | Custom identifier for the view |
↳ external_id | string | Custom external identifier (max 255 chars, unique per workspace) |
↳ state | json | Current state of the view with input values |
↳ hash | string | View version hash for updates |
↳ clear_on_close | boolean | Whether to clear all views in the stack when this view is closed |
↳ notify_on_close | boolean | Whether to send a view_closed event when this view is closed |
↳ root_view_id | string | ID of the root view in the view stack |
↳ previous_view_id | string | ID of the previous view in the view stack |
↳ app_id | string | Application identifier |
↳ bot_id | string | Bot identifier |
Push a new view onto an existing modal stack in Slack. Limited to 2 additional views after the initial modal is opened.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
triggerId | string | Yes | Exchange a trigger to post to the user. Obtained from an interaction payload (e.g., button click within an existing modal) |
interactivityPointer | string | No | Alternative to trigger_id for posting to user |
view | json | Yes | A view payload object defining the modal to push. Must include type ("modal"), title, and blocks array |
| Parameter | Type | Description |
|---|
view | object | The pushed modal view object |
↳ id | string | Unique view identifier |
↳ team_id | string | Workspace/team ID |
↳ type | string | View type (e.g., "modal") |
↳ title | json | Plain text title object with type and text fields |
↳ type | string | Text object type (plain_text) |
↳ text | string | Title text content |
↳ submit | json | Plain text submit button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Submit button text |
↳ close | json | Plain text close button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Close button text |
↳ blocks | array | Block Kit blocks in the view |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ private_metadata | string | Private metadata string passed with the view |
↳ callback_id | string | Custom identifier for the view |
↳ external_id | string | Custom external identifier (max 255 chars, unique per workspace) |
↳ state | json | Current state of the view with input values |
↳ hash | string | View version hash for updates |
↳ clear_on_close | boolean | Whether to clear all views in the stack when this view is closed |
↳ notify_on_close | boolean | Whether to send a view_closed event when this view is closed |
↳ root_view_id | string | ID of the root view in the view stack |
↳ previous_view_id | string | ID of the previous view in the view stack |
↳ app_id | string | Application identifier |
↳ bot_id | string | Bot identifier |
Publish a static view to a user's Home tab in Slack. Used to create or update the app's Home tab experience.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
userId | string | Yes | The user ID to publish the Home tab view to (e.g., U0BPQUNTA) |
hash | string | No | View state hash to protect against race conditions. Obtained from a previous views response |
view | json | Yes | A view payload object defining the Home tab. Must include type ("home") and blocks array |
| Parameter | Type | Description |
|---|
view | object | The published Home tab view object |
↳ id | string | Unique view identifier |
↳ team_id | string | Workspace/team ID |
↳ type | string | View type (e.g., "modal") |
↳ title | json | Plain text title object with type and text fields |
↳ type | string | Text object type (plain_text) |
↳ text | string | Title text content |
↳ submit | json | Plain text submit button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Submit button text |
↳ close | json | Plain text close button object |
↳ type | string | Text object type (plain_text) |
↳ text | string | Close button text |
↳ blocks | array | Block Kit blocks in the view |
↳ type | string | Block type (section, divider, image, actions, etc.) |
↳ block_id | string | Unique block identifier |
↳ private_metadata | string | Private metadata string passed with the view |
↳ callback_id | string | Custom identifier for the view |
↳ external_id | string | Custom external identifier (max 255 chars, unique per workspace) |
↳ state | json | Current state of the view with input values |
↳ hash | string | View version hash for updates |
↳ clear_on_close | boolean | Whether to clear all views in the stack when this view is closed |
↳ notify_on_close | boolean | Whether to send a view_closed event when this view is closed |
↳ root_view_id | string | ID of the root view in the view stack |
↳ previous_view_id | string | ID of the previous view in the view stack |
↳ app_id | string | Application identifier |
↳ bot_id | string | Bot identifier |
Schedule a message to be sent to a Slack channel or DM at a future time.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel, private group, or DM to receive the message (e.g., C1234567890) |
postAt | number | Yes | Unix timestamp (seconds) representing the future time the message should post |
text | string | No | Message text to send (supports Slack mrkdwn formatting) |
blocks | json | No | Block Kit layout blocks as a JSON array. When provided, text becomes the fallback notification text. |
threadTs | string | No | Thread timestamp to reply to (creates a scheduled thread reply) |
| Parameter | Type | Description |
|---|
scheduledMessageId | string | Identifier of the scheduled message (used to delete it before it posts) |
postAt | number | Unix timestamp when the message will post |
channel | string | Channel ID where the message is scheduled |
message | object | The scheduled message object returned by Slack |
List pending scheduled messages in a Slack workspace, optionally filtered by channel.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | No | Optional channel ID to filter scheduled messages (e.g., C1234567890) |
limit | number | No | Maximum number of scheduled messages to return |
cursor | string | No | Pagination cursor (next_cursor) from a previous response |
oldest | string | No | Unix timestamp of the oldest scheduled message to include |
latest | string | No | Unix timestamp of the latest scheduled message to include |
teamId | string | No | Encoded team ID (required only with org-level tokens) |
| Parameter | Type | Description |
|---|
scheduledMessages | array | Array of pending scheduled message objects |
↳ id | string | Scheduled message ID |
↳ channel_id | string | Channel the message is scheduled for |
↳ post_at | number | Unix timestamp when the message will post |
↳ date_created | number | Unix timestamp when the schedule was created |
↳ text | string | Scheduled message text |
nextCursor | string | Cursor for the next page (null when there are no more pages) |
Delete a pending scheduled message before it posts to Slack.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | Channel ID where the scheduled message is queued (e.g., C1234567890) |
scheduledMessageId | string | Yes | Scheduled message ID from chat.scheduleMessage (e.g., Q1234ABCD) |
| Parameter | Type | Description |
|---|
ok | boolean | Whether the scheduled message was deleted successfully |
Archive a Slack channel so it is closed to new activity.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | ID of the channel to archive (e.g., C1234567890) |
| Parameter | Type | Description |
|---|
ok | boolean | Whether the conversation was archived successfully |
Rename an existing Slack channel.
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | ID of the channel to rename (e.g., C1234567890) |
name | string | Yes | New channel name (lowercase letters, numbers, hyphens, underscores only; max 80 characters) |
| Parameter | Type | Description |
|---|
channelInfo | object | The channel object after renaming |
↳ id | string | Channel ID (e.g., C1234567890) |
↳ name | string | Channel name without # prefix |
↳ is_channel | boolean | Whether this is a channel |
↳ is_private | boolean | Whether channel is private |
↳ is_archived | boolean | Whether channel is archived |
↳ is_general | boolean | Whether this is the general channel |
↳ is_member | boolean | Whether the bot/user is a member |
↳ is_shared | boolean | Whether channel is shared across workspaces |
↳ is_ext_shared | boolean | Whether channel is externally shared |
↳ is_org_shared | boolean | Whether channel is org-wide shared |
↳ num_members | number | Number of members in the channel |
↳ topic | string | Channel topic |
↳ purpose | string | Channel purpose/description |
↳ created | number | Unix timestamp when channel was created |
↳ creator | string | User ID of channel creator |
↳ updated | number | Unix timestamp of last update |
Set the topic for a Slack channel (max 250 characters).
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | ID of the channel to update (e.g., C1234567890) |
topic | string | Yes | New topic text (max 250 characters; no formatting or linkification) |
| Parameter | Type | Description |
|---|
channelInfo | object | The channel object after updating the topic |
↳ id | string | Channel ID (e.g., C1234567890) |
↳ name | string | Channel name without # prefix |
↳ is_channel | boolean | Whether this is a channel |
↳ is_private | boolean | Whether channel is private |
↳ is_archived | boolean | Whether channel is archived |
↳ is_general | boolean | Whether this is the general channel |
↳ is_member | boolean | Whether the bot/user is a member |
↳ is_shared | boolean | Whether channel is shared across workspaces |
↳ is_ext_shared | boolean | Whether channel is externally shared |
↳ is_org_shared | boolean | Whether channel is org-wide shared |
↳ num_members | number | Number of members in the channel |
↳ topic | string | Channel topic |
↳ purpose | string | Channel purpose/description |
↳ created | number | Unix timestamp when channel was created |
↳ creator | string | User ID of channel creator |
↳ updated | number | Unix timestamp of last update |
Set the purpose (description) for a Slack channel (max 250 characters).
| Parameter | Type | Required | Description |
|---|
authMethod | string | No | Authentication method: oauth or bot_token |
botToken | string | No | Bot token for Custom Bot |
channel | string | Yes | ID of the channel to update (e.g., C1234567890) |
purpose | string | Yes | New purpose/description text (max 250 characters) |
| Parameter | Type | Description |
|---|
purpose | string | The purpose/description that was set on the channel |
A Trigger is a block that starts a workflow when an event happens in this service.
Trigger from Slack events, interactions, and slash commands
| Parameter | Type | Required | Description |
|---|
eventType | string | Yes | The single Slack event this trigger fires on. Add another trigger block for another event. |
customBotCredential | string | Yes | Choose a custom Slack bot you set up once and reuse across triggers. |
manualBotCredential | string | Yes | Set the custom bot credential ID directly. |
source | string | No | Restrict to direct messages, public channels, or private channels. Leave empty to match any. |
channelFilter | channel-selector | No | Restrict to specific channels. Leave empty to trigger on any channel the bot has been added to. |
manualChannelFilter | string | No | Comma-separated channel IDs to restrict to. Set IDs directly here. |
threads | string | No | Include thread replies, exclude them (top-level only), or fire only on thread replies. |
streamResponse | boolean | No | Create a Slack agent session and stream selected workflow outputs into the conversation that started this run. Custom bots only. |
streamOutputs | workflow-output-selector | No | Use <blockName>.<outputPath> for this workflow or <childWorkflowId>.<blockName>.<outputPath> for a child workflow. Selecting a child workflow applies to every invocation of it. Agent outputs stream live; other outputs are sent when the block completes. |
streamTaskTitle | string | No | Optional status Slack shows while each selected response is being produced. Leave empty to use Running. |
streamTaskDisplayMode | string | No | Choose how Slack displays thinking and tool progress. |
streamIncludeThinking | boolean | No | Show agent thinking as Slack task updates while the response is generated. |
streamIncludeToolCalls | boolean | No | Show tool execution lifecycle as Slack task updates. |
emoji | string | No | Comma-separated emoji names to restrict to. Leave empty to match any emoji. |
nameContains | string | No | Only fire when the created channel name contains this text. |
interactionFilter | string | No | Comma-separated action_ids (buttons/selects) or callback_ids (modals) to restrict to. Leave empty to fire on any interaction. |
commandFilter | string | No | Restrict this trigger to one slash command. Leave empty to fire for every command configured on the bot. |
filterBotMessages | boolean | No | Ignore messages sent by other bots. This app's own output is always ignored. |
includeOwnMessages | boolean | No | Also fire on this app's own messages and reactions. Can cause loops — use with care. |
includeFiles | boolean | No | Download and include file attachments from messages. Requires files:read. |
| Parameter | Type | Description |
|---|
event | object | Slack event data |
↳ event_type | string | Type of Slack payload: an Events API event (e.g., app_mention, message), an interactivity type (e.g., block_actions), or "slash_command" for slash commands |
↳ subtype | string | Message subtype (e.g., channel_join, channel_leave, bot_message, file_share). Null for regular user messages |
↳ channel | string | Slack channel ID where the event occurred |
↳ channel_name | string | Human-readable channel name |
↳ channel_type | string | Type of channel (e.g., channel, group, im, mpim). Useful for distinguishing DMs from public channels |
↳ user | string | User ID who triggered the event |
↳ user_name | string | Username who triggered the event |
↳ bot_id | string | Bot ID if the message was sent by a bot. Null for human users |
↳ text | string | Message text content. For slash commands, the text after the command. For interactivity, the source message text (falls back to the triggering action value) |
↳ timestamp | string | Message timestamp from the triggering event |
↳ thread_ts | string | Parent thread timestamp (if message is in a thread) |
↳ streaming_message_ts | array | Message timestamps streamed during a stopped agent session |
↳ title | string | Current agent session title |
↳ previous_title | string | Previous agent session title |
↳ tab | string | App Home tab that was opened, including messages for Agent View |
↳ context | json | Current Agent View context. Normalized from context on app_context_changed/app_home_opened or app_context on message.im |
↳ team_id | string | Slack workspace/team ID |
↳ user_team_id | string | Slack workspace/team ID of the user who triggered the event. Used for Slack Connect response streaming. |
↳ enterprise_id | string | Slack Enterprise Grid organization ID |
↳ event_id | string | Unique event identifier |
↳ reaction | string | Emoji reaction name (e.g., thumbsup). Present for reaction_added/reaction_removed events |
↳ item_user | string | User ID of the original message author. Present for reaction_added/reaction_removed events |
↳ command | string | Slash command name including the leading slash (e.g., /deploy). Present for slash commands |
↳ action_id | string | action_id of the first interactive element triggered. Present for block_actions (button/select clicks) |
↳ action_value | string | Value carried by the first interactive element (button value, selected option, date, etc.). Present for block_actions |
↳ actions | json | Full array of interactive actions from the payload, preserving every element and its value. Present for block_actions |
↳ response_url | string | Temporary URL to post a response back to the originating message or command. Present for interactivity and slash commands |
↳ trigger_id | string | Short-lived trigger ID used to open a modal in response. Present for interactivity and slash commands |
↳ callback_id | string | Callback ID of the shortcut or view. Present for shortcuts and modal submissions |
↳ api_app_id | string | Slack app ID. Present for interactivity and slash commands |
↳ app_id | string | App ID of the app that produced the event (e.g. the bot that posted a message). Used to identify the app's own output |
↳ message_ts | string | Timestamp of the message the interaction originated from. Present for block_actions |
↳ view | json | Full Slack view object for modal interactions: state.values (submitted input values), private_metadata, id, callback_id, and hash. Present for view_submission/view_closed; null otherwise |
↳ message | json | Full source message object the interaction came from, including its blocks and text. Present for block_actions on a message; null otherwise |
↳ state | json | Current values of all stateful elements in the surface (state.values) at the time of a block action — e.g. inputs read on a button click. Present for block_actions; null otherwise |
↳ hasFiles | boolean | Whether the message has file attachments |
↳ files | file[] | File attachments downloaded from the message (if includeFiles is enabled and bot token is provided) |