Slack

What you can do

Connect this agent connector to let your agent:

• Send messages — post to channels, DMs, and threads on behalf of your users
• Read conversations — retrieve channel history, thread replies, and direct messages
• Manage channels — create channels, invite members, and update channel settings
• Look up users — search for team members by name, email, or username
• Upload files — share files and attachments into any conversation

Authentication

This connector uses OAuth 2.0. Scalekit acts as the OAuth client: it redirects your user to Slack, obtains an access token, and automatically refreshes it before it expires. Your agent code never handles tokens directly — you only pass a connectionName and a user identifier.

You supply your Slack Connected App credentials (Client ID + Secret) once per environment in the Scalekit dashboard.

Set up the connector

Register your Scalekit environment with the Slack connector so Scalekit handles the authentication flow and token lifecycle for you. The connection name you create will be used to identify and invoke the connection programmatically. Then complete the configuration in your application as follows:

1. Set up auth redirects

   • In Scalekit dashboard, go to Agent Auth → Create Connection. Find Slack and click Create. Copy the redirect URI. It looks like https://<SCALEKIT_ENVIRONMENT_URL>/sso/v1/oauth/<CONNECTION_ID>/callback.

     

   • Log in to api.slack.com/apps and click Create New App.

   • Select From scratch, enter an app name, and select your workspace.

   • Go to OAuth & Permissions and scroll to Redirect URLs.

   • Click Add New Redirect URL and paste the redirect URI from Scalekit. Click Add.

     

2. Enable distribution

   • In your Slack app settings, go to Manage Distribution and enable it.

     

   • From Basic Information, copy the Client ID and Client Secret.

3. Add credentials in Scalekit

   • In Scalekit dashboard, go to Agent Auth → Connections and open the connection you created.

   • Enter your credentials:

     • Client ID
     • Client Secret
     • Permissions (scopes — see Slack Scopes documentation)

     

   • Click Save.

Code examples

Connect a user’s Slack account and make API calls on their behalf — Scalekit handles OAuth and token management automatically.

Proxy API Calls

Node.js

import { ScalekitClient } from '@scalekit-sdk/node';
import 'dotenv/config';

const connectionName = 'slack'; // get your connection name from connection configurations
const identifier = 'user_123';  // your unique user identifier

// Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
const scalekit = new ScalekitClient(
  process.env.SCALEKIT_ENV_URL,
  process.env.SCALEKIT_CLIENT_ID,
  process.env.SCALEKIT_CLIENT_SECRET
);
const actions = scalekit.actions;

// Authenticate the user
const { link } = await actions.getAuthorizationLink({
  connectionName,
  identifier,
});
console.log('🔗 Authorize Slack:', link);
process.stdout.write('Press Enter after authorizing...');
await new Promise(r => process.stdin.once('data', r));

// Make a request via Scalekit proxy
const result = await actions.request({
  connectionName,
  identifier,
  path: '/api/auth.test',
  method: 'POST',
});
console.log(result);

Python

import scalekit.client, os
from dotenv import load_dotenv
load_dotenv()

connection_name = "slack"  # get your connection name from connection configurations
identifier = "user_123"     # your unique user identifier

# Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
scalekit_client = scalekit.client.ScalekitClient(
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
    env_url=os.getenv("SCALEKIT_ENV_URL"),
)
actions = scalekit_client.actions

# Authenticate the user
link_response = actions.get_authorization_link(
    connection_name=connection_name,
    identifier=identifier
)
# present this link to your user for authorization, or click it yourself for testing
print("🔗 Authorize Slack:", link_response.link)
input("Press Enter after authorizing...")

# Make a request via Scalekit proxy
result = actions.request(
    connection_name=connection_name,
    identifier=identifier,
    path="/api/auth.test",
    method="POST"
)
print(result)

Tool list

slack_add_reaction Add an emoji reaction to a message in Slack. Requires a valid Slack OAuth2 connection with reactions:write scope. 3 params ▾

Add an emoji reaction to a message in Slack. Requires a valid Slack OAuth2 connection with reactions:write scope.

Name Type Required Description

channel string required Channel ID or channel name where the message exists

name string required Emoji name to react with (without colons)

timestamp string required Timestamp of the message to add reaction to

slack_create_channel Creates a new public or private channel in a Slack workspace. Requires a valid Slack OAuth2 connection with channels:manage scope for public channels or groups:write scope for private channels. 3 params ▾

Creates a new public or private channel in a Slack workspace. Requires a valid Slack OAuth2 connection with channels:manage scope for public channels or groups:write scope for private channels.

Name Type Required Description

name string required Name of the channel to create (without # prefix)

is_private boolean optional Create a private channel instead of public

team_id string optional Encoded team ID to create channel in (if using org tokens)

slack_delete_message Deletes a message from a Slack channel or direct message. Requires a valid Slack OAuth2 connection with chat:write scope. 2 params ▾

Deletes a message from a Slack channel or direct message. Requires a valid Slack OAuth2 connection with chat:write scope.

Name Type Required Description

channel string required Channel ID, channel name (#general), or user ID for DM where the message was sent

ts string required Timestamp of the message to delete

slack_fetch_conversation_history Fetches conversation history from a Slack channel or direct message with pagination support. Requires a valid Slack OAuth2 connection with channels:history scope. 5 params ▾

Fetches conversation history from a Slack channel or direct message with pagination support. Requires a valid Slack OAuth2 connection with channels:history scope.

Name Type Required Description

channel string required Channel ID, channel name (#general), or user ID for DM

cursor string optional Paginate through collections by cursor for pagination

latest string optional End of time range of messages to include in results

limit integer optional Number of messages to return (1-1000, default 100)

oldest string optional Start of time range of messages to include in results

slack_get_conversation_info Retrieve information about a Slack channel, including metadata, settings, and member count. Requires a valid Slack OAuth2 connection with channels:read scope. 3 params ▾

Retrieve information about a Slack channel, including metadata, settings, and member count. Requires a valid Slack OAuth2 connection with channels:read scope.

Name Type Required Description

channel string required Channel ID, channel name (#general), or user ID for DM

include_locale boolean optional Set to true to include the locale for this conversation

include_num_members boolean optional Set to true to include the member count for the conversation

slack_get_conversation_replies Retrieve replies to a specific message thread in a Slack channel or direct message. Requires a valid Slack OAuth2 connection with channels:history or groups:history scope. 7 params ▾

Retrieve replies to a specific message thread in a Slack channel or direct message. Requires a valid Slack OAuth2 connection with channels:history or groups:history scope.

Name Type Required Description

channel string required Channel ID, channel name (#general), or user ID for DM

ts string required Timestamp of the parent message to get replies for

cursor string optional Pagination cursor for retrieving next page of results

inclusive boolean optional Include messages with latest or oldest timestamp in results

latest string optional End of time range of messages to include in results

limit integer optional Number of messages to return (default 100, max 1000)

oldest string optional Start of time range of messages to include in results

slack_get_user_info Retrieves detailed information about a specific Slack user, including profile data, status, and workspace information. Requires a valid Slack OAuth2 connection with users:read scope. 2 params ▾

Retrieves detailed information about a specific Slack user, including profile data, status, and workspace information. Requires a valid Slack OAuth2 connection with users:read scope.

Name Type Required Description

user string required User ID to get information about

include_locale boolean optional Set to true to include locale information for the user

slack_get_user_presence Gets the current presence status of a Slack user (active, away, etc.). Indicates whether the user is currently online and available. Requires a valid Slack OAuth2 connection with users:read scope. 1 param ▾

Gets the current presence status of a Slack user (active, away, etc.). Indicates whether the user is currently online and available. Requires a valid Slack OAuth2 connection with users:read scope.

Name Type Required Description

user string required User ID to check presence for

slack_invite_users_to_channel Invites one or more users to a Slack channel. Requires a valid Slack OAuth2 connection with channels:write scope for public channels or groups:write for private channels. 2 params ▾

Invites one or more users to a Slack channel. Requires a valid Slack OAuth2 connection with channels:write scope for public channels or groups:write for private channels.

Name Type Required Description

channel string required Channel ID or channel name (#general) to invite users to

users string required Comma-separated list of user IDs to invite to the channel

slack_join_conversation Joins an existing Slack channel. The authenticated user will become a member of the channel. Requires a valid Slack OAuth2 connection with channels:write scope for public channels. 1 param ▾

Joins an existing Slack channel. The authenticated user will become a member of the channel. Requires a valid Slack OAuth2 connection with channels:write scope for public channels.

Name Type Required Description

channel string required Channel ID or channel name (#general) to join

slack_leave_conversation Leaves a Slack channel. The authenticated user will be removed from the channel and will no longer receive messages from it. Requires a valid Slack OAuth2 connection with channels:write scope for public channels or groups:write for private channels. 1 param ▾

Leaves a Slack channel. The authenticated user will be removed from the channel and will no longer receive messages from it. Requires a valid Slack OAuth2 connection with channels:write scope for public channels or groups:write for private channels.

Name Type Required Description

channel string required Channel ID or channel name (#general) to leave

slack_list_channels List all public and private channels in a Slack workspace that the authenticated user has access to. Requires a valid Slack OAuth2 connection with channels:read, groups:read, mpim:read, and/or im:read scopes depending on conversation types needed. 5 params ▾

List all public and private channels in a Slack workspace that the authenticated user has access to. Requires a valid Slack OAuth2 connection with channels:read, groups:read, mpim:read, and/or im:read scopes depending on conversation types needed.

Name Type Required Description

cursor string optional Pagination cursor for retrieving next page of results

exclude_archived boolean optional Exclude archived channels from the list

limit integer optional Number of channels to return (default 100, max 1000)

team_id string optional Encoded team ID to list channels for (optional)

types string optional Mix and match channel types (public_channel, private_channel, mpim, im)

slack_list_users Lists all users in a Slack workspace, including information about their status, profile, and presence. Requires a valid Slack OAuth2 connection with users:read scope. 4 params ▾

Lists all users in a Slack workspace, including information about their status, profile, and presence. Requires a valid Slack OAuth2 connection with users:read scope.

Name Type Required Description

cursor string optional Pagination cursor for fetching additional pages of users

include_locale boolean optional Set to true to include locale information for each user

limit number optional Number of users to return (1-1000)

team_id string optional Encoded team ID to list users for (if using org tokens)

slack_lookup_user_by_email Find a user by their registered email address in a Slack workspace. Requires a valid Slack OAuth2 connection with users:read.email scope. Cannot be used by custom bot users. 1 param ▾

Find a user by their registered email address in a Slack workspace. Requires a valid Slack OAuth2 connection with users:read.email scope. Cannot be used by custom bot users.

Name Type Required Description

email string required Email address to search for users by

slack_pin_message Pin a message to a Slack channel. Pinned messages are highlighted and easily accessible to channel members. Requires a valid Slack OAuth2 connection with pins:write scope. 2 params ▾

Pin a message to a Slack channel. Pinned messages are highlighted and easily accessible to channel members. Requires a valid Slack OAuth2 connection with pins:write scope.

Name Type Required Description

channel string required Channel ID or channel name where the message exists

timestamp string required Timestamp of the message to pin

slack_send_message Sends a message to a Slack channel or direct message. Requires a valid Slack OAuth2 connection with chat:write scope. 10 params ▾

Sends a message to a Slack channel or direct message. Requires a valid Slack OAuth2 connection with chat:write scope.

Name Type Required Description

channel string required Channel ID, channel name (#general), or user ID for DM

text string required Message text content

attachments string optional JSON-encoded array of attachment objects for additional message formatting

blocks string optional JSON-encoded array of Block Kit block elements for rich message formatting

reply_broadcast boolean optional Used in conjunction with thread_ts to broadcast reply to channel

schema_version string optional Optional schema version to use for tool execution

thread_ts string optional Timestamp of parent message to reply in thread

tool_version string optional Optional tool version to use for execution

unfurl_links boolean optional Enable or disable link previews

unfurl_media boolean optional Enable or disable media link previews

slack_set_user_status Set the user's custom status with text and emoji. This appears in their profile and can include an expiration time. Requires a valid Slack OAuth2 connection with users.profile:write scope. 3 params ▾

Set the user's custom status with text and emoji. This appears in their profile and can include an expiration time. Requires a valid Slack OAuth2 connection with users.profile:write scope.

Name Type Required Description

status_emoji string optional Emoji to display with status (without colons)

status_expiration integer optional Unix timestamp when status should expire

status_text string optional Status text to display

slack_update_message Updates/edits a previously sent message in a Slack channel or direct message. Requires a valid Slack OAuth2 connection with chat:write scope. 5 params ▾

Updates/edits a previously sent message in a Slack channel or direct message. Requires a valid Slack OAuth2 connection with chat:write scope.

Name Type Required Description

channel string required Channel ID, channel name (#general), or user ID for DM where the message was sent

ts string required Timestamp of the message to update

attachments string optional JSON-encoded array of attachment objects for additional message formatting

blocks string optional JSON-encoded array of Block Kit block elements for rich message formatting

text string optional New message text content