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

# Slack integration for test alerts

> Send Qodex scheduled test-run summaries to a Slack channel through an incoming webhook. Configure the webhook and verify delivery.

# Slack

Use the Slack integration when your team wants scheduled test results to land in a channel.

Qodex sends the notification when a scheduled run finishes. The message includes the run status, failed scenarios, regressions, environment, duration, cadence, and a link back to the full run.

## How Slack notifications work

Each schedule can store a webhook URL and a notification rule.

| Setting | What it does |
| - | - |
| Webhook URL | Destination for the run-completion notification. |
| `notifyOn: always` | Send a message after every run. |
| `notifyOn: failure` | Send only when the run fails. |
| `notifyOn: never` | Do not send schedule notifications. |

If the URL host is `hooks.slack.com`, Qodex sends a Slack-formatted message. If the URL is any other HTTPS endpoint, Qodex sends the generic JSON webhook payload instead.

## 1. Create a Slack incoming webhook

In Slack, create an incoming webhook for the channel that should receive Qodex updates.

Slack returns a URL like:

```text theme={null}
https://hooks.slack.com/services/T.../B.../...
```

Keep this URL private. Anyone with it can post to that channel.

## 2. Add it to a schedule

In Qodex, open **Test runs** in the left navigation, then click **Schedules**.

Create or edit a schedule, paste the Slack webhook URL into the **Webhook URL** field, choose when Qodex should notify the channel, and save.

## 3. Test the notification

Run the schedule on demand or wait for the next scheduled run.

When the run finishes, the Slack channel should receive a summary with a link to the test run. If nothing arrives, check that the webhook URL is valid and that the schedule's notification rule is not set to `never`.

## Current limit

This page describes Slack incoming webhooks. A full Slack App with slash commands, bot users, threading, and richer channel controls is planned but not currently shipped.

Use [Generic webhook](https://qodex.ai/docs/integrations-generic-webhook.md) if you want to route the same run event through your own relay.

## Next steps

> [card] [Run tests on a schedule](https://qodex.ai/docs/run-tests-on-schedule.md)
>
> Configure the schedule that sends Slack notifications.

> [card] [Generic webhook](https://qodex.ai/docs/integrations-generic-webhook.md)
>
> Send the same event shape to any HTTPS endpoint.

> [card] [Findings overview](https://qodex.ai/docs/findings.md)
>
> Understand what failed runs mean.

> [card] [Integrations](https://qodex.ai/docs/integrations.md)
>
> Return to all integrations.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.