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

> ## Agent Instructions
> Spur is an AI-powered QA engineer that lets teams create and run automated end-to-end tests for web and mobile apps using natural language.
> When answering questions about Spur, cite the relevant page from docs.spurtest.com.

# Slack Alerts

> Connect Spur with Slack for real-time test result notifications in your workspace.

## Overview

The Slack integration sends test result notifications directly to a channel in your workspace. You can receive alerts when tests fail, when they pass, or get a daily summary of all results.

## Setup

<Steps>
  <Step title="Create a Slack channel">
    In your Slack workspace, create a new channel for Spur notifications (e.g. `#spur_alerts`).
  </Step>

  <Step title="Connect Slack in Spur">
    Navigate to the Integrations page and click **Connect** on the Slack card. Authorize Spur to access your workspace when prompted.

    <Card icon="slack" iconType="brands" href="https://app.spurtest.com/integrations" title="Connect Slack">
      Go to the Integrations page in Spur to connect your Slack workspace.
    </Card>
  </Step>
</Steps>

## Permissions

When you authorize the integration, Spur requests the following Slack OAuth scopes. Each one maps directly to a feature of the integration:

| Scope | Why Spur needs it |
| - | - |
| `chat:write` | Sends test result alerts and end-of-day summaries to your chosen channel as Spur. |
| `channels:read` | Lists the public channels in your workspace so you can pick a notification channel when configuring alerts or test plans. |
| `groups:read` | Lists private channels that Spur has been added to, so they also appear in the channel picker. |
| `channels:join` | Lets Spur join a public channel automatically when it needs to deliver an alert there, so you don't have to invite the bot manually. |
| `incoming-webhook` | Lets you post Spur alerts to a specific channel via a webhook URL as an alternative to selecting a channel. |
| `links:read` | Detects when `app.spurtest.com` test result links are shared in your channels. |
| `links:write` | Shows rich previews of shared `app.spurtest.com` links, including the test name, status, and failure reason. |
| `links.embed:write` | Embeds the test recording video player directly in those link previews. |
| `app_mentions:read` | Lets Spur see messages that directly @-mention the Spur app in channels it has been added to. |

<Note>
  Spur can only see channel names for the channel picker and messages that contain `app.spurtest.com` links or @-mention Spur. It cannot read your other messages.
</Note>

## Notification Options

Once connected, you can choose when Spur sends alerts to your channel:

* **On Fail** — Get notified when one or more tests fail.
* **On Pass** — Get notified when tests pass.
* **End of Day Summary** — A daily digest of all test results.

<Tip>
  You can also customize the Slack channel and notification trigger per test plan. Test plans can send alerts to their own dedicated channels. See the [Running Test Plans](/running-tests/test-plans) page for details.
</Tip>


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