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

# Setup

> Step-by-step guide to connecting Slack to Prizm via OAuth and routing alert notifications to public or private channels.

<script type="application/ld+json">
  {`{
            "@context": "https://schema.org",
            "@type": "TechArticle",
            "headline": "Slack Setup",
            "description": "Step-by-step guide to connecting Slack to Prizm via OAuth and routing alert notifications to public or private channels.",
            "url": "https://docs.dqlabs.ai/integrations/slack/setup",
            "publisher": {
              "@type": "Organization",
              "name": "DQLabs Inc",
              "logo": "https://media.brand.dev/332adc35-5bc4-4d2b-bf78-256aa4a5e414.svg"
            }
            }`}
</script>

## Connecting Slack to Prizm

Prizm connects to Slack via OAuth. The authorization takes about one minute — Slack handles authentication automatically and no webhook URLs or bot tokens need to be entered manually.

### Prerequisites

* A Slack account with permission to authorize OAuth applications in your workspace
* Access to the channels where Prizm should send notifications
* For private channels: the ability to run `/invite @PRIZM` in each channel after connecting

### Connect Slack in Prizm

<Steps>
  <Step title="Open the channel catalog">
    Navigate to **Organization** → **Integration** and click **Add** to open the channel catalog. Click the **Slack** tile to begin the OAuth flow.
  </Step>

  <Step title="Authorize with Slack">
    A popup opens redirecting you to Slack. Sign in with the account that has access to your workspace, select the workspace where Prizm should send notifications, and approve the requested permissions. Once authorized, you are returned to Prizm and Slack appears in your integration list with the connected workspace name.
  </Step>

  <Step title="Invite Prizm to private channels (if applicable)">
    Prizm can post to any public channel automatically. For private channels, open the channel in Slack and run:

    ```text theme={null}
    /invite @PRIZM
    ```

    Repeat for each private channel you want to use as a notification target.
  </Step>

  <Step title="Send a test notification">
    Navigate to **Organization** → **Integration**, click the pencil icon next to Slack, and click **Test Notification** to confirm delivery to the default channel.
  </Step>

  <Step title="Save the configuration">
    Click **Update Integration**. The Slack tile shows the connected workspace as active.
  </Step>
</Steps>

### Configuration reference

| Field         | Description                                                                           |
| ------------- | ------------------------------------------------------------------------------------- |
| **Workspace** | The Slack workspace connected via OAuth. Populated automatically after authorization. |
| **Status**    | Connection status (Active or error). Click **Reconnect** if the status is not Active. |
| **Last Sync** | Timestamp of the most recent successful Prizm–Slack communication.                    |

<Note>
  The Slack OAuth connection is tied to the account that authorized the integration. If that account is deactivated or loses the required permissions, click **Reconnect** to re-authorize with a different account. For private channels, remember to run `/invite @PRIZM` before routing alerts there.
</Note>