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

# Slack

> Receive Oso alert notifications in Slack.

Connect Oso to Slack to receive alert notifications in a channel of your choice. Each notification links directly to the alert details page in Oso for investigation.

## Prerequisites

* An Oso for Agents account with at least one [alert](https://www.osohq.com/docs/oso-for-agents/alerts.md) configured
* Permission to add apps to your Slack workspace (or a workspace admin who can approve it)

## Connect Slack

1. In Oso, go to **Settings** and click the **Integrations** tab.

2. Click **Connect** next to Slack.

![Oso integrations settings page](https://mintcdn.com/osoinc/RsJbsaYjnb-AQ_8q/images/integrations/slack/settings_integrations.png?fit=max\&auto=format\&n=RsJbsaYjnb-AQ_8q\&q=85\&s=8724bf90fd2b165f0f8f986cf54e918e)

3. You will be redirected to Slack to authorize the Oso app.

## Choose a notification channel

1. Once redirected, select the Slack channel where alert notifications should be posted.

![Slack channel selection in Oso](https://mintcdn.com/osoinc/RsJbsaYjnb-AQ_8q/images/integrations/slack/channel_select.png?fit=max\&auto=format\&n=RsJbsaYjnb-AQ_8q\&q=85\&s=77eb079ef2254ae93bcb7c875045a94a)

2. Click **Allow**.

3. On the next Alert the configured channel should receive a slack message.

## What a notification looks like

Each Slack notification includes:

* **What was detected** — the alert type
* **Who was involved** — the agent, user, or device

![Example Slack alert notification](https://mintcdn.com/osoinc/RsJbsaYjnb-AQ_8q/images/integrations/slack/notification_example.png?fit=max\&auto=format\&n=RsJbsaYjnb-AQ_8q\&q=85\&s=cc67e4b9ad477bd4a8dd4909ef622ea9)

## Disconnecting Slack

To disconnect, go to **Settings → Integrations → Slack** and click **Disconnect**. Oso will stop sending notifications immediately. Reconnecting will prompt you to re-authorize and re-select a channel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.