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

# Connecting Slack

> Install the ClarityQ Slack app for your workspace so tasks, reports, and answers can flow into Slack.

Connecting Slack lets ClarityQ post task results, scheduled reports, and answers into your team's Slack workspace, and lets your team ask questions of ClarityQ without leaving Slack. The connection is at the workspace level — one ClarityQ organization links to one Slack workspace, and every product in that organization can use it.

## Prerequisites

* A Slack workspace where you have permission to install apps.
* Admin rights in your ClarityQ organization.

## Installing the App

<Steps>
  <Step title="Open Organization Settings → Integrations">
    Navigate to **Organization Settings → Integrations** in ClarityQ.
  </Step>

  <Step title="Click Add ClarityQ to Slack">
    The **Add ClarityQ to Slack** button kicks off the OAuth flow and redirects you to Slack.
  </Step>

  <Step title="Approve the requested scopes">
    Review the permissions ClarityQ requests — posting messages, reading channel and member lists, uploading files, responding to mentions, and handling slash commands — and click **Allow**.
  </Step>

  <Step title="Return to ClarityQ">
    Slack redirects you back to ClarityQ once the install is complete. The Integrations page now shows **Connected to *your workspace name***.
  </Step>
</Steps>

## Choosing Channels

ClarityQ can post to:

* **Public channels** in your Slack workspace, automatically.
* **Private channels**, but only after you invite the ClarityQ bot to that channel with `/invite @ClarityQ`.

The channel picker appears when you create or edit a [task](/automations/creating-and-scheduling-tasks). It lists every channel the bot can see — public, plus any private channels it's been invited to.

## Disconnecting and Reconnecting

Two actions are available on the Integrations page once Slack is connected:

* **Disconnect** removes ClarityQ's access to your Slack workspace. After confirmation, the bot stops posting and pending task deliveries fail. Existing tasks keep their channel selections but won't deliver until Slack is reconnected.
* **Reconnect** re-runs the OAuth flow with the latest permission set. Use this when:
  * Slack reports a permissions error
  * ClarityQ tells you the integration needs to be reauthorized (for example, when ClarityQ adds new scopes in a release)
  * You want to enable new capabilities — for example, if you originally connected Slack only for task deliveries and now want to ask ClarityQ questions directly in Slack, reconnecting grants the additional permissions needed

<Note>
  Slack connections are per organization, not per user. Once an admin connects Slack, every product in your organization can deliver to that Slack workspace. If a user's Slack email matches their ClarityQ login email, they're recognized automatically. Otherwise, they'll need to run `/clarityq connect` once — see [Using ClarityQ in Slack](/integrations/slack/using-clarityq-in-slack).
</Note>