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

# Slack channels

> Auto-create and manage a dedicated Slack channel per incident.

When a Slack workspace is connected, Obsy can automatically create a dedicated channel for each new incident, mirror messages back into the incident timeline, and archive the channel after resolution.

<Note>
  Slack must be connected first. Go to **Integrations** and click **Connect Slack** to authorize the bot.
</Note>

## Enable auto-create

1. Go to **Incidents → Settings** (the gear icon on the Incidents page, or **Settings → Incidents**).
2. Find the **Slack & incident channels** card.
3. Toggle **Auto-create a Slack channel for each incident** on.

## Channel name template

Customize the channel name using these placeholders:

| Placeholder    | Example output         |
| -------------- | ---------------------- |
| `{{id}}`       | `inc-00042`            |
| `{{title}}`    | `payment-service-503s` |
| `{{severity}}` | `sev1`                 |
| `{{date}}`     | `2026-01-15`           |

Default template: `inc-{{date}}-{{severity}}`
Example result: `inc-2026-01-15-sev1`

Slack channel names are lowercased and spaces are replaced with hyphens automatically.

## General notification channel

Set a **general Slack channel** to receive a message whenever a new incident is created (in addition to the dedicated incident channel). Useful for keeping a high-level `#incidents` channel in sync.

## Two-way Slack sync

Messages typed in the incident's Slack channel are mirrored back into the Obsy incident timeline in real time. This lets you use Slack as your working space while keeping a permanent record in Obsy.

For this to work, your Slack app must have the **Events API** configured pointing to:

```
https://api.obsy.ai/api/v1/webhooks/slack/events
```

And the following event subscriptions enabled:

* `message.channels`
* `message.groups`

See [Slack setup](/integrations/slack) for the full Slack App configuration guide.

## Archive on resolution

Enable **Archive channel after resolution** and set the number of days (default 7). Obsy's hourly sweeper archives the channel N days after the incident is resolved. The Slack link in the incident detail is preserved even after archiving.

## Open the Slack channel

On the incident detail page, click the **Open in Slack** link next to the channel name to jump directly to the channel in Slack.

## Manual channel creation

If auto-create is off, you can still manually create a channel from the incident detail: click **Create Slack channel** in the Actions panel. This uses the same name template.