Slack Join Channel
Controlled node
Overview
Joins a Slack channel using a configured Slack connection. The bot user associated with the connection must have permission to join the target channel. This node is useful for programmatically joining channels in workflows that need to post messages or monitor specific channels.
Inputs
| Input | Type | Description | Default |
|---|---|---|---|
| Run | Event | Fires when the node starts running | - |
| Channel ID | Text | The ID of the Slack channel to join (e.g., "C1234567890") | - |
Outputs
| Output | Type | Description |
|---|---|---|
| Done | Event | Fires when the node has finished |
| Status | Data | Returns "success" if the channel was joined successfully, or an error object with details if the operation failed |
Properties
| Property | Type | Description | Default |
|---|---|---|---|
| Connections | Connection | The Slack connection to use for this operation. Configure Slack connections in your project settings. | - |
Runtime Behavior and Defaults
This node requires a valid Slack connection to be selected in the properties panel before it can execute. The bot user associated with the selected connection must have the necessary permissions to join channels in your Slack workspace.
When triggered:
- Validates that a Slack connection is configured
- Validates that a Channel ID is provided
- Attempts to join the specified channel using the Slack API
- Returns "success" in the Status output if successful, or an error object if the join operation fails (e.g., if the bot lacks permissions or the channel doesn't exist)
Note: The Channel ID is different from the channel name. Channel IDs typically start with "C" for public channels or "G" for private channels/groups.
Example Usage
Basic Channel Join
- Connect a Start node or any event-emitting node to the Run input
- Enter the Channel ID (e.g., "C1234567890") in the Channel ID field, or connect a Text node providing the channel ID
- Select your Slack connection in the Connections property panel
- Connect the Done event to subsequent nodes that should run after joining the channel
- Optionally, connect the Status output to a condition check or logging node to verify the join was successful
Error Handling
To handle cases where the join might fail (e.g., the bot is already in the channel or lacks permissions):
- Connect the Status output to an If node
- Check if Status equals "success"
- If false, handle the error appropriately (e.g., log the error or notify the user)