> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpander.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Slack

> Connect Slack to xpander and give agents its 36 actions: how to sign in and connect it, and which actions to hold for approval.

HTTP API connector

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to `https://slack.com/api` and carry an OAuth 2.0 token obtained with **Sign in with Slack** on the cloud edition, or an API key or custom header on a self-hosted installation, which offers no sign-in flow.

## What the skill can do

API connector: 36 actions, as they appear in the skill panel. 15 of them create, change or delete something in Slack; mark those under **These actions need approval** when you add the skill to an agent.

* **Conversation management** (11): Create New Channel, List Available Chats, Get Conversation Info, Invite Users To Channel, Fetch Channel Participants, Open Direct Message, Update Channel Purpose, Update Channel Topic, Join Channel, Rename Channel, Get Thread Messages
* **Other** (9): Message Sending Send Ephemeral Msg To User, Dnd Info Get User Status, Pin List Channel Pins, User Lookup By Email, Reaction Remove Emoji From Message, Message Permalink Retrieve Link, Reaction Add Emoji To Message, Reaction Get For Message, Pin Add Message To Channel
* **Message service** (6): Update Message In Channel, Schedule Message In Channel, Send Message To Channel, Fetch Conversation History, Search Messages, List Scheduled Messages
* **Remote file service** (2): List Team Channels, List Files With Filters
* **File management** (2): Get File Details, Upload File To Slack
* **Team management** (2): Get Team Info, List Team Members
* **User management** (2): Get User Profile, Get User Details
* **Bot management** (1): Get Bot User Info
* **Emoji service** (1): List Team Emojis

> [!NOTE]
>
> **Want to talk to agents in Slack?** Follow the [Slack workspace guide](https://docs.xpander.ai/guides/deploy/slack-and-teams.md) to connect Omni, authorize agent handles, and configure channel auto-engagement. This page covers giving an agent Slack skills; authorizing this skill does not create an agent handle.

## Authentication Options

> [tab] Built-in xpander Auth
>
> The simplest way to connect Slack is by using xpander's built-in authentication:
>
> 1. In xpander Chat, open the agent's settings and click **Add skill**.
> 2. Search for **Slack** and select it.
> 3. Click **Sign in with Slack**.
> 4. Grant xpander permission to access specific channels in your Slack workspace.
> 5. Your Slack integration is now ready to use.

> [tab] API Access
>
> ### Generate a Slack API Key
>
> 1. Log in to [Slack Apps](https://api.slack.com/apps).
>
> 2. Click **Create an App**, then select **From scratch**.
>
> 3. Give your app a name, and select the Slack workspace you want to develop it in.
>
>    ![Img 1](https://mintcdn.com/xpanderai-099931d1/sRFk58mKeQVVrCwf/images/connectors/slack/img_1.png?fit=max\&auto=format\&n=sRFk58mKeQVVrCwf\&q=85\&s=156b7ab1cd26fde4155e33441a9d66f8)
>
> 4. After clicking **Create App**, go to the **OAuth & Permissions** section in the sidebar.
>
>    ![Img 2](https://mintcdn.com/xpanderai-099931d1/sRFk58mKeQVVrCwf/images/connectors/slack/img_2.png?fit=max\&auto=format\&n=sRFk58mKeQVVrCwf\&q=85\&s=155f5e97877dc6876435bedfe4bb58de)
>
> 5. Under the **Scopes** section, in **Bot Token Scopes**, click **Add an OAuth Scope** and select the permissions your app needs.\
>    You can browse all available scopes [here](https://api.slack.com/scopes).
>
>    ![Img 3](https://mintcdn.com/xpanderai-099931d1/sRFk58mKeQVVrCwf/images/connectors/slack/img_3.png?fit=max\&auto=format\&n=sRFk58mKeQVVrCwf\&q=85\&s=5900134a1667e75b134d4e8776fb1aa4)
>
> 6. Still in **OAuth & Permissions**, scroll to **OAuth Tokens** and click **Install to \<YOUR-WORKSPACE>**.
>
>    ![Img 4](https://mintcdn.com/xpanderai-099931d1/sRFk58mKeQVVrCwf/images/connectors/slack/img_4.png?fit=max\&auto=format\&n=sRFk58mKeQVVrCwf\&q=85\&s=dfd2b1148662a7410e979f235a02bb0f)
>
> 7. After installation, your Slack access token will be displayed. Save it securely.
>
>    ![Img 5](https://mintcdn.com/xpanderai-099931d1/sRFk58mKeQVVrCwf/images/connectors/slack/img_5.png?fit=max\&auto=format\&n=sRFk58mKeQVVrCwf\&q=85\&s=44d63621c8b744d0fa01217b89f0a06a)
>
> ### Connect Slack in xpander
>
> 1. In xpander Chat, open the agent's settings and click **Add skill**.
> 2. Search for **Slack** and select it.
> 3. Click **Other auth options**.
> 4. Enter a **connection name**, e.g., "xpander-slack".
> 5. Choose **Organization** access (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](https://docs.xpander.ai/use/agents/permissions.md#whose-credential-a-shared-agent-uses).
> 6. Select **API Key** as the authentication method.
> 7. Paste the Slack access token into the provided field.
> 8. Set the **Type** to **Bearer**.
> 9. Click **Connect**.

## Give an agent the Slack skill

Once Slack is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Slack**. The skill panel lists the Slack actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](https://docs.xpander.ai/use/skills.md).

## Related Resources

* [Skills](https://docs.xpander.ai/use/skills.md)
* [Slack API Documentation](https://api.slack.com/quickstart)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.