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

# Slack

> Configure a workflow step that sends, reads, searches, and manages Slack messages and channels using a connected account

Use **Slack** when you want a workflow step to send messages, read channel history, list channels, search messages, or manage related Slack activity from a connected account.

## Configuration

| Option              | Required | Description                                                                                                                                                                                              |
| ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                | No       | Label for the step in the workflow canvas.                                                                                                                                                               |
| Authentication      | Yes      | The connected Slack account to use for this step.                                                                                                                                                        |
| Action              | Yes      | The Slack action to perform (for example Send Message, Fetch Conversation History, List All Channels).                                                                                                   |
| Arguments           | Yes      | Per-action form fields generated from the action's schema. Each text field has an **Insert Variable** button for injecting `{{placeholder}}` values. A **Raw JSON** tab is available for advanced usage. |
| When the step fails | No       | Controls whether the workflow should **Terminate Workflow** or **Continue** if this step fails.                                                                                                          |

Before you configure this step, connect Slack in **Integrations** for your workspace using the OAuth flow. If no active connection is available, the step shows a warning with a link to **Integrations** instead of the account selector.

## Arguments form

When you select an action, the **Arguments** section automatically renders a form driven by the action's input schema. Each field includes:

* A label and description from the action's schema.
* An **Insert Variable** button next to eligible fields that injects references like `{{step_1.output.id}}` at the cursor position.
* Validation feedback inline if a required field is left empty.

Switch to the **Raw JSON** tab for power users or when you prefer to write the full arguments object by hand. Changes in either tab stay in sync.

Channel fields often support a picker populated from your connected workspace. Prefer channel IDs when the action requires them.

## Common actions

| Action                     | Description                                          |
| -------------------------- | ---------------------------------------------------- |
| Send Message               | Post a message to a channel, DM, or private group.   |
| Schedule Message           | Schedule a message for later delivery.               |
| Update Message             | Edit an existing Slack message.                      |
| Fetch Conversation History | Read recent messages from a channel or conversation. |
| Fetch Message Thread       | Retrieve replies in a message thread.                |
| Search Messages            | Search messages across the workspace.                |
| List All Channels          | List channels available to the connected account.    |
| Find Channels              | Search for channels by name or related criteria.     |
| Find Users                 | Look up users in the workspace.                      |
| Join Conversation          | Join an existing public conversation.                |
| Open DM                    | Open a direct message conversation.                  |
| Create Reminder            | Create a Slack reminder.                             |
| Upload File                | Upload or create a file in Slack.                    |
| Add Reaction               | Add an emoji reaction to a message.                  |
| Test Auth                  | Confirm the connected account is valid.              |

Destructive actions such as deleting messages, deleting channels, or removing users are not exposed in the workflow action picker.

## Output

This step stores the Slack API response as the step output. The shape of the response depends on the action.

Use the full output reference in later steps:

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

For example, after a **Send Message** step you might reference fields from the returned payload:

```text theme={null}
{{step_2.output.ts}}
```

## Example

1. Open **Integrations** and connect Slack if you have not already done that.
2. Add a **Slack** step to your workflow.
3. Select a connected account in **Authentication**.
4. Choose **Fetch Conversation History** in **Action** to collect channel messages, or **Send Message** to post.
5. In the **Arguments** form, fill in the channel and any message text. Use **Insert Variable** to reference an earlier step's output for any field value.
6. Click **Run** in the step header to test the action, then review the returned payload in **Output**.

## Notes

* This step depends on a connected Slack integration in your workspace.
* The workflow action picker shows a curated subset of Slack actions. Agents with the Slack tool can access additional safe actions.
* OAuth may show third-party authorization branding during the connect flow.
* If you previously connected Slack before the multi-action update, reconnect Slack in **Integrations** so the account can use the expanded action set.

## Using Slack as an Agent Tool

You can also add Slack as a tool in the **Agent Editor**. Open the agent, click **Add tool**, and select **Slack**. In the tool settings panel, choose the connected account the agent should use. The agent will call Slack actions automatically during conversations when relevant.

See also: [Integrations](../../../workspace/integrations), [Creating and Editing](../../creating-and-editing), and [Testing and Iteration](../../testing-and-iteration)