Slack
API actions for the Slack integration.
Slack
Send and manage Slack messages, channels, and reactions with a bot token.
Add a reaction
Add an emoji reaction to a Slack message.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
channel_id | string | Yes | Channel ID containing the message (e.g., C123456). IMPORTANT: Must be a channel ID, not a channel name. |
timestamp | string | Yes | Message timestamp (ts) to react to. Use the 'ts' field from the send-message response. |
emoji | string | Yes | Emoji name without colons (e.g., thumbsup). |
Response
{
"status": "example_value"
}Archive a channel
Archive a Slack channel by ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
channel_id | string | Yes | The channel ID to archive (e.g., C123456). IMPORTANT: Must be a channel ID, not a channel name. |
Response
{
"status": "example_value"
}Create a channel
Create a new public or private Slack channel. The returned channel object contains an 'id' field that must be used for subsequent operations (NOT the channel name).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Channel name (lowercase, no spaces). |
is_private | boolean | No | Whether the channel should be private. |
topic | string | No | (Optional) Topic to set after creation. |
Response
{
"channel": {
"id": "example_value",
"is_archived": true,
"is_private": true,
"name": "example_value"
},
"status": "example_value"
}List channels
Retrieve visible channels for the bot, optionally excluding archived ones.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
exclude_archived | boolean | No | Whether to hide archived channels. |
limit | number | No | Maximum number of channels to return (1-1000). |
Response
{
"channels": [],
"status": "example_value"
}Schedule a message
Schedule a message to be posted at a future Unix timestamp.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
channel_id | string | Yes | Channel ID where the message will be sent (e.g., C123456). IMPORTANT: Must be a channel ID, not a channel name. |
text | string | Yes | Message text to schedule. |
post_at | number | Yes | Unix timestamp (seconds) when the message should be posted. |
Response
{
"channel": "example_value",
"post_at": "example_value",
"status": "example_value"
}Send a direct message
Open a DM with a user and send them a message.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id | string | Yes | The Slack user ID to DM (e.g., U123456). |
text | string | Yes | The message text to send. |
Response
{
"channel": "example_value",
"status": "example_value",
"ts": "example_value"
}Send a message to a channel
Post a message to a public or private Slack channel using a bot token.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
channel_id | string | Yes | The Slack channel ID (e.g., C123456). IMPORTANT: Must be a channel ID, not a channel name. |
text | string | Yes | The message text to send. |
thread_ts | string | No | (Optional) Thread timestamp to reply in a thread. |
Response
{
"channel": "example_value",
"status": "example_value",
"ts": "example_value"
}