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

# How do I set up the Juicebox + Slack integration?

> Connect the Juicebox app to your Slack workspace and link individual projects to Slack channels.

Setting up the Juicebox + Slack integration is a two-part process:

1. A Slack admin connects the Juicebox app to your Slack workspace.
2. Anyone can then link individual Juicebox projects to specific Slack channels.

## Before you start

* You must be a **Slack workspace admin** to complete the initial connection.
* We recommend signing into Slack in your browser before starting. If you aren't signed in, the OAuth flow is harder to complete. Sign in at [slack.com/signin](https://slack.com/signin).

## Part 1: Connect the Juicebox app to your Slack workspace

1. Head to the **Integrations** tab in Juicebox: [app.juicebox.ai/?tab=integrations](https://app.juicebox.ai/?tab=integrations).

2. Find the **Get Juicebox notifications in Slack** card and select **Connect Slack**.

   <img src="https://mintcdn.com/juicebox-16ef85b6/z9KxEbEzjAD-NUwG/images/help/integrations/slack-setup-1-connect-card.png?fit=max&auto=format&n=z9KxEbEzjAD-NUwG&q=85&s=2036ec275376a3370c77ffa9f190bff5" alt="Connect Slack card on the Integrations page" width="1458" height="502" data-path="images/help/integrations/slack-setup-1-connect-card.png" />

3. You'll be redirected to Slack's native permission page. Confirm the correct workspace is selected in the **Workspace** dropdown, review the permissions, and click **Allow**.

   <img src="https://mintcdn.com/juicebox-16ef85b6/z9KxEbEzjAD-NUwG/images/help/integrations/slack-setup-2-slack-allow.png?fit=max&auto=format&n=z9KxEbEzjAD-NUwG&q=85&s=805b0f209c31ffb350e86f9aa4039807" alt="Slack native permission page for the Juicebox app" width="2508" height="1798" data-path="images/help/integrations/slack-setup-2-slack-allow.png" />

4. You'll be redirected back to Juicebox. The connection card now shows **Manage connections** — admin setup is done.

   <img src="https://mintcdn.com/juicebox-16ef85b6/z9KxEbEzjAD-NUwG/images/help/integrations/slack-setup-3-manage-connections.png?fit=max&auto=format&n=z9KxEbEzjAD-NUwG&q=85&s=90a3eb9b8d45db05f59508d420d6395d" alt="Manage connections state on the Integrations page" width="1450" height="472" data-path="images/help/integrations/slack-setup-3-manage-connections.png" />

## Part 2: Add Juicebox to a Slack channel

To use Juicebox inside Slack, add the app to each channel where you want it to post and respond.

1. In Slack, open the channel and select the channel name at the top to open channel details. Go to the **Agents & apps** tab and select **Add Agent or App**.

   <img src="https://mintcdn.com/juicebox-16ef85b6/z9KxEbEzjAD-NUwG/images/help/integrations/slack-setup-4-agents-apps-tab.png?fit=max&auto=format&n=z9KxEbEzjAD-NUwG&q=85&s=739c1d68474a02a86f6a66ff691bb4a1" alt="Agents and apps tab in a Slack channel" width="1092" height="550" data-path="images/help/integrations/slack-setup-4-agents-apps-tab.png" />

2. Find **Juicebox** in the list and select **Add**.

   <img src="https://mintcdn.com/juicebox-16ef85b6/z9KxEbEzjAD-NUwG/images/help/integrations/slack-setup-5-add-juicebox-app.png?fit=max&auto=format&n=z9KxEbEzjAD-NUwG&q=85&s=d4a0addc904aa56acfc2618f8cd7a68a" alt="Add the Juicebox app to a Slack channel" width="1398" height="670" data-path="images/help/integrations/slack-setup-5-add-juicebox-app.png" />

## Part 3: Link a Juicebox project to a Slack channel

Once the app is connected, you can link each Juicebox project to the Slack channel where the team collaborates on that role.

1. On the **Projects** page, open the project's **…** menu and select **Configure Slack notifications**.

   <img src="https://mintcdn.com/juicebox-16ef85b6/z9KxEbEzjAD-NUwG/images/help/integrations/slack-setup-6-configure-notifications.png?fit=max&auto=format&n=z9KxEbEzjAD-NUwG&q=85&s=2bd8b671128298f4e4e8ba808cfff9a4" alt="Configure Slack notifications from the project menu" width="766" height="580" data-path="images/help/integrations/slack-setup-6-configure-notifications.png" />

2. In the **Slack notifications** modal, choose one of two options:

   <img src="https://mintcdn.com/juicebox-16ef85b6/jD44TU53kHdZfHxF/images/help/integrations/slack-setup-7-project-connect-modal.png?fit=max&auto=format&n=jD44TU53kHdZfHxF&q=85&s=5ae9a6d73bdc9aee09555bb0e596863a" alt="Slack notifications modal for a project" width="1490" height="616" data-path="images/help/integrations/slack-setup-7-project-connect-modal.png" />

   * **Link Project to an existing channel** — select **Link Channel** to connect the project to a Slack channel that already exists.
   * **Create a new channel** — enter a channel name (a suggested name based on the project role is prefilled) and select **Create Channel** to have Juicebox create the channel for you.

3. If you chose **Link Channel**, a Slack page opens. Choose the channel you want notifications posted to under **Channel for webhook** and select **Allow**.

   <img src="https://mintcdn.com/juicebox-16ef85b6/z9KxEbEzjAD-NUwG/images/help/integrations/slack-setup-8-channel-picker.png?fit=max&auto=format&n=z9KxEbEzjAD-NUwG&q=85&s=2fdab8680fa30e72540d2b92594b105a" alt="Slack channel picker for project notifications" width="1860" height="2188" data-path="images/help/integrations/slack-setup-8-channel-picker.png" />

Repeat Part 3 for each project you want linked to Slack.

Still running into issues? Reach out via the in-app support button or email [support@juicebox.ai](mailto:support@juicebox.ai).
