Docs

Integrations / Chat / Slack

Manage Slack Channels

Create, update, archive, and change publicity of Slack channels

Create, update, archive, and change publicity of Slack Channels automatically

What it can do

The Manage Slack Channels tool allows the Risotto agent to create, update, archive, and change channel publicity on your behalf.

  • Create channels The agent can spin up a new public or private Slack channel with a specified name and automatically invite the person requesting it. It can also invite additionally specified users
  • Archive channels The agent can archive a Slack channel that's no longer needed. To restore an archived channel, use Unarchive Slack Channel.
  • Update channels The agent can rename an existing channel or change it between public and private

Example use cases

  • An employee asks "Can you create a #we-love-risotto channel for my team?" and Risotto will create the channel and add the specified Slack users
  • A team lead requests a channel rename, and Risotto's agent will change the name without IT intervention

Authentication

This tool authenticates through the Slack Tools connector. Follow the Slack Tools Setup guide to configure it. Advanced capabilities (archiving private channels or converting channel privacy) require a Slack Enterprise Grid organization and an org-wide install of the connector (the Install across the entire Slack organization option, see Enterprise Grid).

Supported Operations

With Business+, this tool works automatically with the Slack Tools connector. No additional configuration is needed.

Supported Operations

  • Create public and private channels
  • Archive public channels (the bot joins the channel, then archives it)
  • Rename channels

Limitations

  • Cannot archive private channels (the bot cannot join channels it hasn't been invited to)
  • Cannot convert a public channel to private, or vice versa

Enterprise Grid unlocks the full set of capabilities. Check Install across the entire Slack organization when setting up the Slack Tools connector.

Supported Operations

  • Create public and private channels
  • Archive public and private channels, including channels the bot has not joined
  • Rename channels, including channels the bot has not joined
  • Convert a public channel to private
  • Convert a private channel to public

How rename and archive work

With an organization-wide install, the tool renames and archives channels through Slack's admin API first. The admin API does not need the bot in the channel. If Slack refuses the admin call (for example, the user who installed the app is no longer an Org Admin), the tool uses the bot. If the bot also fails, the error ends with "(the admin API also refused: <code>)".

CapabilityBusiness+Enterprise Grid
Create public channels✅✅
Create private channels✅✅
Archive public channels✅✅
Archive private channels❌✅
Rename channels✅✅
Change channel privacy❌✅

Configuration

  1. Set up the Slack Tools connector

    Follow the Slack Tools Setup guide to connect your Slack workspace. If you need Enterprise Grid features, check Install across the entire Slack organization during setup.

  2. Configure the tool

    In the Risotto dashboard, navigate to Tools and select the Manage Slack Channels tool. Choose whether this tool requires admin approval to execute, then save.

  3. Create your Runbook

    Create a custom Runbook or use a Runbook Template from the Risotto Runbook Library to configure your Slack Manage Channels tool.

Using a per-tool token override

If you need this tool to use different credentials than the connector — for example, to operate in a separate workspace — you can provide a custom token directly in the tool configuration:

  • Bot Token — A User OAuth Token (xoxp-) with the required scopes
  • Team ID — Your Slack workspace Team ID (starts with T)

Per-tool tokens take precedence over the connector. See per-tool token override for details.

Troubleshooting

The agent says the tool lacks the scopes to change a channel's privacy

Cause: Converting a channel between public and private, or archiving a private channel, needs Slack's admin.conversations:read and admin.conversations:write scopes, which are only granted by an org-wide Enterprise Grid install.

Solutions:

  • Reconnect the Slack Tools connector from the Tools app card on Settings → Integrations → Slack with Install across the entire Slack organization checked, and have an org owner complete the install. The box is not remembered between setup attempts.
  • If this tool uses a per-tool token override, add both admin.conversations scopes to your own Slack app under OAuth & Permissions, reinstall it at the organization level, and update the token in the tool configuration.
  • On Slack Business+ these operations are not available; see the comparison table above.

Something wrong or missing? Report an issue · View as Markdown