Skip to main content

​
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

1

Access the marketplace

Go to Organization Settings → Marketplace and click on Slack.
2

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.
3

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.
For private channels, invite the Pwnbook Slack app to the channel first: /invite @Pwnbook in the channel before configuring it here.

​
Notification types

You can configure which events trigger Slack notifications:
EventDescription
New engagement createdSent when a new engagement is created in the organization
Engagement archivedSent when an engagement is archived
Task assignedSent when a task is assigned to a team member
Task status changedSent when a task moves to a new status
Recon scan completedSent when a recon scan finishes, with a summary of findings
Report generatedSent when a report is generated and ready for review
New threat identifiedSent when a new threat is added to a threat model
Wiki page sharedSent 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.