Manage Slack Channel Members
Invite, remove, or promote users in Slack channels with automatic bot management
Manages Slack channel membership by inviting users, removing users, or promoting users to Channel Manager. This tool automatically handles bot permissions and provides detailed error messages for troubleshooting.
Authentication
This tool authenticates through the Slack Tools connector. Follow the Slack Tools Setup guide to configure it.
Setup Requirements
Basic Operations (All Slack Plans)
For inviting and removing members, no special setup is required beyond having the Slack Tools connector configured.
Advanced Operations (Enterprise Grid Only)
Configuration Options
When configuring this tool in a runbook, you can set:
- Operation - Action to perform: INVITE, REMOVE, or PROMOTE
- User Email - Email of the user to manage
- Channel ID - Slack channel ID (e.g., 'C1234567890')
- Channel Name - Channel name (used if Channel ID is not provided)
- Role - For INVITE/PROMOTE operations: MEMBER or MANAGER
- Bot Token (Optional override) - Per-tool bot token. Takes precedence over the Slack Tools connector.
- Team ID (Optional) - Required only when using a per-tool bot token override
Features
Automatic Bot Management
The tool automatically handles bot membership:
- Inviting users: When the Slack Tools connector was set up with Install across the entire Slack organization (Enterprise Grid), the tool sends the invite through Slack's admin API first. The admin API does not need the bot in the channel, so it can add a user to a private channel that the bot was never invited to. If the admin API refuses (for example, the token that installed the app no longer belongs to an Org Admin), the tool uses the bot: the bot joins the channel, invites the user, and then leaves. Without an organization-wide install, the tool always uses the bot.
- Invite messages: An invite sent through the admin API adds the user without a "joined" message from the bot in the channel. An invite sent by the bot shows the bot and the user joining together.
- Removing users: Bot automatically joins the channel if needed, then leaves after removal
- Promoting users: Uses org-level admin API without channel membership requirements
Idempotent Operations
Operations are designed to be safe to run multiple times:
- Inviting a user already in the channel returns "User is already in channel" and changes nothing
- Inviting a user who is not a member of the channel's workspace returns a message that says so
- The tool handles channel lookup by name or ID automatically
Smart Channel Resolution
You can specify channels by:
- Channel ID (e.g.,
C1234567890) - Fastest and most reliable - Channel Name (e.g.,
engineering-team) - Automatically searches all channels
Comprehensive Error Handling
The tool provides clear, actionable error messages:
- Permission issues with links to workspace settings
- Missing scope indicators
- Enterprise Grid requirements
- User and channel not found errors
Troubleshooting
Common Issues
Permission Requirements
For Basic Operations (INVITE, REMOVE):
- Bot must have access to the channel (automatically managed)
- Required scopes:
channels:manage,groups:write,users:read.email - Works on all Slack plans
For Channel Manager Promotion (PROMOTE):
- Requires Slack Enterprise Grid
- App must be installed at org level
- Required scope:
admin.roles:write - Bot needs admin privileges in the workspace
Additional Resources
Something wrong or missing? Report an issue · View as Markdown