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

# Slack Integration

> Get real-time deployment notifications and alerts in Slack

## Overview

The Slack integration enables automatic team notifications for two use cases:

* **Deployment notifications**: Get notified whenever changes occur within your applications (deployments, failures, etc.)
* **Alerting notifications**: Receive real-time alerts when your services trigger monitoring conditions (CPU, memory, errors, latency, etc.)

<Note>
  Choose your use case below. Steps 1 and 2 are common for both integrations.
  Step 3 differs depending on your needs.
</Note>

## Step 1: Create a Slack App

Navigate to the [Slack app creation page](https://api.slack.com/apps) and build a new application from scratch. The app should be named "Qovery" and connected to the desired workspace.

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-app-slack-1.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=a46f2ee87d48e7cdfd176ba224fb536f" alt="Create Slack App - Step 1" width="1336" height="240" data-path="images/slack/create-app-slack-1.png" />

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-app-slack-2.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=4b5f4625b34579181e290ecf1e42496d" alt="Create Slack App - Step 2" width="864" height="565" data-path="images/slack/create-app-slack-2.png" />

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-app-slack-3.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=26f93ecf7bb90ec62e2eaf18889aec3e" alt="Create Slack App - Step 3" width="804" height="544" data-path="images/slack/create-app-slack-3.png" />

<Info>
  You can customize your Slack app with an optional logo available from
  [Qovery's public resources
  repository](https://uploads-ssl.webflow.com/6046393ad41fc8c21e77d3d7/60c0dc4f7c3f2e3e6e2c3b5f_qovery-logo-square.png).
</Info>

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-app-slack-4.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=9de544029637107a70c9f5dc600e4538" alt="Customize Slack App" width="939" height="592" data-path="images/slack/create-app-slack-4.png" />

## Step 2: Configure Incoming Webhooks

Activate the Incoming Webhooks feature within your app, then add a new webhook to your workspace. Select the target notification channel and copy the generated webhook URL.

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-webhook-1.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=f44226da5b8761c7eda938bed2d3e333" alt="Activate Incoming Webhooks" width="1093" height="999" data-path="images/slack/create-webhook-1.png" />

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-webhook-2.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=616a8dcd329880266f0f01dc07443d53" alt="Add New Webhook to Workspace" width="999" height="962" data-path="images/slack/create-webhook-2.png" />

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-webhook-3.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=2fda6c4503676240fa6c6ef8f162be16" alt="Select Channel" width="1334" height="684" data-path="images/slack/create-webhook-3.png" />

<img src="https://mintcdn.com/qovery/cLygDq96GM8e7V5d/images/slack/create-webhook-4.png?fit=max&auto=format&n=cLygDq96GM8e7V5d&q=85&s=677deac2a779578120899ea4b6e0f38f" alt="Copy Webhook URL" width="1002" height="1006" data-path="images/slack/create-webhook-4.png" />

## Step 3: Configure Slack in Qovery

Choose your use case:

<Tabs>
  <Tab title="Deployment Notifications">
    ### Configure Qovery Webhook

    Reference the [webhook documentation](/configuration/integrations/webhooks) to establish the connection within Qovery, using the copied Slack webhook URL as the endpoint.

    <Note>
      Multiple webhooks can target different channels. Specific events can be filtered (e.g., `"events": ["DEPLOYMENT_FAILURE"]`). Webhooks are manageable and deletable anytime.
    </Note>

    ### Test the Integration

    Launch a deployment to verify notifications appear in your designated Slack channel.
  </Tab>

  <Tab title="Alerting Notifications">
    ### Add Notification Channel

    1. Navigate to the **Alerting** section in the Qovery Console navigation menu
    2. Click on **Notification channel**
    3. Click the **Add channel** button
    4. In the **New channel** modal:
       * **Display name**: Enter a descriptive name for this notification channel (e.g., "Production Alerts", "Team DevOps")
       * **Webhook URL**: Paste the webhook URL you copied from Step 2
    5. Click **Confirm creation**

    <img src="https://mintcdn.com/qovery/h4GYArJsH08SmRTF/images/slack/notification-channel-setup.png?fit=max&auto=format&n=h4GYArJsH08SmRTF&q=85&s=5cabdbb7419e3c3bb08cc52c9ab6cf9c" alt="Add Notification Channel" width="3164" height="2070" data-path="images/slack/notification-channel-setup.png" />

    <Tip>
      The display name is how this channel will appear when configuring alerts. Choose a clear name that indicates which Slack channel or team will receive these notifications.
    </Tip>

    ### Test the Integration

    Create a test alert with a low threshold to verify notifications appear in your designated Slack channel. See the [Alert Conditions guide](/configuration/integrations/observability/qovery-observe#alerts) for details on creating alerts.
  </Tab>
</Tabs>

## Support

Existing customers can reach out via Pylon directly in the [Qovery console](https://console.qovery.com).