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

# Slack

> Connect a Slack bot, add channel IDs, and verify notification delivery.

Towbar posts operational notifications through one Slack bot token. Create a Slack app with a bot allowed to post messages, install it in the intended workspace, and invite the bot to each target channel. Copy the channel ID rather than the display name so channel renames do not change routing.

```yaml title="/etc/towbar/towbar.yml" theme={"system"}
notifications:
  enabled: true
  providers:
    slack:
      botToken: "xoxb-..."
  routes: []
```

Run `sudo towbar config validate` and `sudo towbar restart`. Open **Manage → Notifications → Slack** and add a destination for each channel ID. Select **Deployments**, **Backup & Restore**, and **Alerts & Incidents** per channel; preview events follow Deployments. Checkbox changes save immediately.

## Test and troubleshoot

Use the row's test action to send a sample notification. If Slack rejects it, verify the bot token, app installation, posting permission, channel ID, and channel membership. A private channel must include the bot. Use [delivery history](/docs/integrations/notifications#delivery-history) for the provider-safe error and retry state. A successful response proves Slack accepted the post, not that someone saw it.

For a single workload, additional Slack channel IDs can be declared in its [manifest notification routing](/docs/deployment-manifest#route-notifications-for-one-app-or-resource). Those appear read-only under the entity's **Monitor → Notifications** page after sync. Keep the bot token in YAML, never in the manifest. Rotate it by applying new YAML, restarting Towbar, and testing a destination before revoking the old token.

<div className="towbar-doc-screenshot">
  <div className="towbar-product-light">
    <img src="https://mintcdn.com/avgeek/ylQA6qTjzIsIRICB/assets/release-v2/slack-notifications-light.jpg?fit=max&auto=format&n=ylQA6qTjzIsIRICB&q=85&s=6f025a082fa6d610a9523528250b4b69" alt="Slack notification destinations and category subscriptions in Towbar." width="2560" height="1440" loading="lazy" data-path="assets/release-v2/slack-notifications-light.jpg" />
  </div>

  <div className="towbar-product-dark">
    <img src="https://mintcdn.com/avgeek/ylQA6qTjzIsIRICB/assets/release-v2/slack-notifications-dark.jpg?fit=max&auto=format&n=ylQA6qTjzIsIRICB&q=85&s=35869d878920ce75f0e8f8749818ba5a" alt="Slack notification destinations and category subscriptions in Towbar." width="2560" height="1440" loading="lazy" data-path="assets/release-v2/slack-notifications-dark.jpg" />
  </div>

  <p>Each Slack channel can subscribe to different operational categories.</p>
</div>