> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://respan.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://respan.ai/docs/_mcp/server.

# Slack

#### Set up Respan

1. **Sign up** — Create an account at [platform.respan.ai](https://platform.respan.ai)
2. **Create an API key** — Generate one on the [API keys page](https://platform.respan.ai/platform/gateway/api-keys)
3. **Add credits or a provider key** — Add credits on the [Credits page](https://platform.respan.ai/platform/gateway/credits) or connect your own provider key on the [Integrations page](https://platform.respan.ai/platform/gateway/api-keys?providers=1)

#### Use AI

Add the [Docs MCP](/docs/documentation/get-started/mcp/docs-mcp) to your AI coding tool to get help building with Respan. No API key needed.

```json
{
  "mcpServers": {
    "respan-docs": {
      "url": "https://mcp.respan.ai/mcp/docs"
    }
  }
}
```

Connect a Slack workspace to Respan so monitors, automations, and other workflow notifications can post directly to a channel. The connection is per-organization: install it once, then any channel the Respan bot can reach becomes available as a notification destination.

## Connect Slack

#### Open the Integrations page

Go to the [Integrations page](https://platform.respan.ai/platform/settings/integrations) under Settings. Find **Slack** in the Workspace section and click **connect** button.

![Slack row on the Respan Integrations page](/docs/_fern-img/993e51391f1f23ddefd5563ddb36f2cc4d098cfcf064f8360ad9daa426a330c3.webp)

#### Approve the Respan app in Slack

Clicking **Connect** opens a Slack consent popup. Pick the workspace you want to connect and review the scopes Respan is requesting, then click **Allow**.

![Slack OAuth consent screen requesting Respan permissions](/docs/_fern-img/637fc489e3df162778f16b9cad94ecf4bc54c2683f6a74fa8c94381b561d0810.webp)

Respan requests the minimum scopes needed to post messages and let you pick channels:

| Scope                          | Purpose                                                    |
| ------------------------------ | ---------------------------------------------------------- |
| `chat:write`                   | Post messages as the Respan bot                            |
| `chat:write.public`            | Post to public channels without being invited first        |
| `channels:read`, `groups:read` | List public and private channels in the channel picker     |
| `channels:join`                | Let the bot join public channels automatically when needed |
| `users:read`                   | Resolve user identities for alert payloads                 |

#### Confirm the connection

The popup closes on its own once Slack finishes the handshake. The Integrations page refreshes and shows the workspace name and connected state.

![Integrations page showing Slack connected to a workspace](/docs/_fern-img/5c39ea5aecfd4facae829f4ffbc43496d9238e92707a49bd643469d80ce074de.webp)

## Use Slack in Respan

Once connected, Slack shows up as a notification destination anywhere Respan sends alerts.

### Monitor alerts

Open a [monitor](/docs/documentation/features/monitoring/monitors) and, under **Notifications**, select **Slack**. Pick a channel from the searchable dropdown — the list is fetched live from the connected workspace.

![Channel picker dropdown for Slack notifications in Respan](/docs/_fern-img/0411edd768ed731305348bb48bcd75d39c1f13c85b3c67a2ed2fb489f8204473.webp)

> **Note**
>
> Private channels only appear in the picker if the Respan bot has been invited. In Slack, type `/invite @Respan` in the channel you want alerts to land in.

### Multiple destinations

A single monitor or automation can post to more than one Slack channel. Add each channel as its own notification destination — Respan will fan out the message.

## Disconnect Slack

On the Integrations page, click **Disconnect** on the Slack row. Respan revokes the OAuth token with Slack and removes any stored channel references. You can reconnect at any time; previous monitor configurations that referenced Slack channels will need a new channel selection after reconnecting.

> **Note**
>
> Disconnecting does not remove the Respan app from your Slack workspace. If you also want to remove the app itself, go to your Slack workspace's **Apps** page and remove **Respan**.

## Troubleshooting

#### The popup closed but the integration still shows disconnected

The Slack consent flow failed — usually because the Slack workspace admin requires app approval, or the browser blocked third-party cookies during the handshake. Try again in a non-private browser window. If your workspace restricts app installs, ask a Slack admin to approve Respan first.

#### A private channel is missing from the picker

The Respan bot only sees private channels it has been invited to. Open the channel in Slack and run `/invite @Respan`, then reopen the channel picker in Respan.

#### Alerts stopped arriving after a long pause

Slack admins can revoke app tokens from the workspace's admin console. If that happens the integration will start failing silently. Disconnect and reconnect on the Integrations page to issue a fresh token.