---
updatedAt: 2026-09-15T13:54:54.000Z
agentTools:
  projectIndex: https://docs.customgpt.ai/llms.txt
---

# Connect your CustomGPT.ai account to Slack

This guide walks you through connecting your CustomGPT.ai account to Slack using OAuth. This replaces the need to generate and paste an API key.

## Before you start

* You have Owner or Admin access on your CustomGPT.ai account.
* You have permission to install apps in your Slack workspace.

***

## Steps

1. On your CustomGPT.ai agent, click the three dots menu and select **Deploy** icon.

<Image src="https://files.readme.io/bc2daa53535cd55d6976c039756114ce93d5571bf4df46ebfc80ee525e2d72ec-deploy.png" align="center" border={true} />

2. Go to the **Integrations&#x20;**&#x74;ab.

![](https://files.readme.io/09278fcdaeb52e084fdde8ca12830eedc96fc14ad1fbd0917cc93b1b24fd1e3d-Integrations_tab.png)

3. Find the **Slack** card and click **Connect**.

![](https://files.readme.io/93e05aaa0955ea50a9b1431677f8fb41f5cb3b1cf1a80846a917aa5d5eb43f06-connect_button_on_Salck_card.png)

4. You're redirected to Slack. Click **Allow** to authorize the CustomGPT.ai app for your workspace.

![](https://files.readme.io/5e2661469598e7021c11dd808fe73c8639fb1645c683c08002d00322cefc4ee9-Slack_OAuth_page_for_Customgpt_integration.png)

6. You're redirected back to CustomGPT.ai to the **Connect with Slack** screen, which asks for permission to chat with the agents you select. Click **Select agents**.

![](https://files.readme.io/801a50fe1f2d792b9916a5fff95e2ac0f62f94d1292538d57bbd855fc41f1afb-Select_agent_Slack.png)

7. Select which agent(s) you want to connect to Slack.
   * Use **Select all** to select every agent at once.
   * Use the search bar to find a specific agent.

![](https://files.readme.io/5db023fb27d1f8c35a326cc650221ba71dd3e41b18db7cb0998d0498f64f84ae-allow_slack_to_connect_to_agents.png)

8. Click **Allow access**.

![](https://files.readme.io/55fa04e2fef1f94363caefde8edee9feaa0a96b84fb10e2770a2e05c0eac5682-Allow_access_button_to_connect_to_Slack.png)

<Callout icon="📘" theme="info">
  **Note:** Slack may prompt you to open its desktop app or continue in your browser.
</Callout>

You'll land on the CustomGPT.ai app in Slack. From here:

* To set a primary agent for the workspace and control who can talk to it, see [Set up primary Slack agent](https://docs.customgpt.ai/docs/setting-up-slack-primary-agent).
* To control who can invite agents to a channel, see [Configure agent access in Slack workspace](https://docs.customgpt.ai/docs/configure-project-access-in-slack-workspace).

***

## Existing connections made with an API key

If you connected to Slack before this update using an API key, that connection keeps working - you don't need to redo anything. See [Connect to Slack using an API key (Legacy)](#) if you still need to set up or troubleshoot that path.

***

## Turn on file uploads for an existing connection

If your agent isn't reading files sent in Slack, you may have connected to Slack before file uploads were supported. Turn on the extra Slack permission it needs:

1. In Slack, go to **CustomGPT** and click the **Connection** tab.
2. Scroll to the bottom and click **Click here to allow**.

New connections include this permission automatically. Refer to [How file uploads work in Slack](https://docs.customgpt.ai/docs/how-file-uploads-work-in-slack) for what your agent does with an uploaded file.

***

## Related articles

* [Manage your Slack connections](#)
* [Deploy to a Slack channel](https://docs.customgpt.ai/docs/deploy-your-project-to-slack-channel)
* [Configure Project Access in Slack Workspace](https://docs.customgpt.ai/docs/configure-project-access-in-slack-workspace)
* [Connect to Slack using an API key (Legacy)](#)