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

# Slack

> Set up and use the Slack integration with Hyper AI

Auth type: OAuth

<Info>
  For a primer on connecting apps and managing permissions, see: [App Integrations](/integrations/overview).
</Info>

## Connect Slack

1. Go to Settings → Apps in Hyper
2. Select Slack → Connect New
3. Approve requested scopes and choose the workspace

## Common capabilities

* Post messages and threads
* Fetch channel history and files (per permissions)
* Drive agent handoffs and approvals from Slack

## Use in Chat

Enable Slack in the tool selector to let agents read or post updates directly from conversations.

## Use in Agents

Add Slack to an agent’s toolkits, choose a connection, and require approval for posting in designated channels if desired.

## Use in Flows

Add Slack nodes for notifications, approvals, and escalations. Combine with Gmail/CRM steps for end‑to‑end workflows.

## Troubleshooting

* Not posting: verify channel permissions and bot membership
* Missing history: check scope coverage and private channel access

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                  | Description                                                                                |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| Add Reaction            | Add a reaction emoji to a message                                                          |
| Archive Channel         | Archive a channel                                                                          |
| Create Channel          | Create a new channel (public or private)                                                   |
| Create Reminder         | Create a reminder for a user at a specific time                                            |
| Delete File             | Delete a file from Slack                                                                   |
| Delete Message          | Delete a message from a channel                                                            |
| Find User By Email      | Find a Slack user by their email address                                                   |
| Get Channel History     | Get recent messages from a channel                                                         |
| Get Channel Info        | Get detailed information about a channel                                                   |
| Get Channel Members     | Get list of members in a channel                                                           |
| Get File Info           | Get information about a file by its ID                                                     |
| Get Thread Replies      | Get all replies in a message thread                                                        |
| Get User Presence       | Get user presence status (active/away)                                                     |
| Get User Profile        | Get detailed profile information for a specific user                                       |
| Get User Timezone       | Get user timezone information                                                              |
| Get Users               | Get a list of all users in the workspace with their basic profile information              |
| Invite Users To Channel | Invite users to a channel                                                                  |
| Join Channel            | Have the bot join a public channel by ID                                                   |
| Kick User From Channel  | Remove a user from a channel                                                               |
| List Channels           | List public channels where the bot is a member                                             |
| List Files              | List files in the workspace with optional filters by channel, user, or team                |
| List Group Members      | List all users in a user group                                                             |
| List Reactions          | List all reactions on a specific message                                                   |
| List User Channels      | List all public channels visible to the authenticated user (not limited to bot membership) |
| Pin Message             | Pin a message to a channel                                                                 |
| Post Message            | Post a new message to a Slack channel                                                      |
| Reply To Thread         | Reply to a specific message thread in Slack                                                |
| Search Messages         | Search for messages across Slack channels                                                  |
| Send Block Kit Message  | Send a rich formatted message using Slack Block Kit                                        |
| Send Large Message      | Send a large message over 3000 characters to Slack                                         |
| Set Channel Purpose     | Set the purpose for a channel                                                              |
| Set Channel Topic       | Set the topic for a channel                                                                |
| Set User Status         | Set your own status message and emoji                                                      |
| Unarchive Channel       | Unarchive a channel                                                                        |
| Unpin Message           | Unpin a message from a channel                                                             |
| Update Group Members    | Add or remove users from a user group                                                      |
| Update Message          | Update/edit an existing message in a channel                                               |
| Update Profile          | Update user profile fields such as name, title, email, phone, or pronouns                  |
| Upload File             |                                                                                            |