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

# Slack Integration

> Connect Pwnbook to Slack to receive notifications about engagement activity, task updates, recon scan completions, and security alerts directly in your Slack channels.

## Overview

The Slack integration lets Pwnbook send notifications to your Slack workspace. Keep your team informed about important events without requiring everyone to check the Pwnbook UI constantly.

## Setting up the Slack integration

<Steps>
  <Step title="Access the marketplace">
    Go to **Organization Settings** → **Marketplace** and click on **Slack**.
  </Step>

  <Step title="Authorize Pwnbook in Slack">
    Click **Connect Slack**. You'll be redirected to Slack to authorize the Pwnbook app in your workspace.

    Select the Slack workspace you want to connect and click **Allow**.

    You'll be redirected back to Pwnbook once authorization is complete.
  </Step>

  <Step title="Configure notification channels">
    After authorization, configure which Slack channels receive which types of notifications:

    1. Click **Configure Channels** in the Slack integration settings.
    2. For each notification type, select a channel from the dropdown (shows all public channels and any private channels the Pwnbook app has been added to).
    3. Click **Save**.

    <Tip>For private channels, invite the Pwnbook Slack app to the channel first: `/invite @Pwnbook` in the channel before configuring it here.</Tip>
  </Step>
</Steps>

## Notification types

You can configure which events trigger Slack notifications:

| Event                      | Description                                                 |
| -------------------------- | ----------------------------------------------------------- |
| **New engagement created** | Sent when a new engagement is created in the organization   |
| **Engagement archived**    | Sent when an engagement is archived                         |
| **Task assigned**          | Sent when a task is assigned to a team member               |
| **Task status changed**    | Sent when a task moves to a new status                      |
| **Recon scan completed**   | Sent when a recon scan finishes, with a summary of findings |
| **Report generated**       | Sent when a report is generated and ready for review        |
| **New threat identified**  | Sent when a new threat is added to a threat model           |
| **Wiki page shared**       | Sent when an external share link is created                 |

Each notification type can be sent to a different channel. For example, you might route task updates to a `#pentest-tasks` channel and recon results to `#pentest-recon`.

## Engagement-level notifications

For fine-grained control, you can configure Slack notifications per engagement:

1. Open an engagement.
2. Click **Settings** → **Notifications**.
3. Toggle on Slack notifications for this engagement.
4. Select the channel to use.

Engagement-level settings override the organization-level defaults for that specific engagement.

## Notification format

Slack notifications from Pwnbook include:

* The event type and a short description
* A link directly to the relevant item in Pwnbook (engagement, task, scan result, etc.)
* The name of the team member who triggered the event
* Timestamp

Example notification:

```
🔍 Recon scan completed for engagement: Acme Corp External
  Target: acmecorp.com
  Discovered: 12 subdomains, 4 open ports, 2 web technologies
  View results → https://app.pwnbook.io/engagements/123/recon
```

## Disconnecting Slack

To disconnect the Slack integration:

1. Go to **Organization Settings** → **Marketplace** → **Slack**.
2. Click **Disconnect**.
3. Confirm the disconnection.

Disconnecting stops all future notifications. The Pwnbook app remains installed in your Slack workspace; you can remove it from the Slack App Directory settings if needed.