Skip to main content

Overview

Plane is an open-source project management tool. The Pwnbook Plane integration allows tasks created in Pwnbook to be synced as issues in a Plane project, keeping your security work visible in your existing project management workflow.
The Plane integration is currently in early access. Core sync functionality is available, but some features (such as bidirectional sync and real-time updates) are still in development.

Prerequisites

  • A Plane account (Cloud or self-hosted)
  • A Plane API key
  • The workspace slug and project ID you want to sync with
  • Admin or Owner access in Pwnbook to configure the integration

Credentials required

FieldDescription
API KeyA Plane API key. Generate one in Plane Profile Settings → API Tokens.
Workspace SlugThe short identifier for your Plane workspace, visible in the URL: app.plane.so/<workspace-slug>/...
Project IDThe UUID of the Plane project to sync tasks into. Found in Project Settings → Members or the URL.

Setup

1

Generate a Plane API key

  1. Log in to your Plane account.
  2. Click your profile picture → Profile Settings.
  3. Go to API Tokens.
  4. Click Add API Token.
  5. Give it a name (e.g., pwnbook) and an optional expiry date.
  6. Copy the generated token.
2

Find your workspace slug and project ID

Workspace slug: Visible in the Plane URL after you’re logged in:
https://app.plane.so/<workspace-slug>/projects/...
Project ID: Go to the project in Plane, then open Settings. The project ID (UUID) is shown there, or you can copy it from the URL:
https://app.plane.so/<workspace-slug>/projects/<project-id>/...
3

Configure the integration in Pwnbook

  1. Go to Organization Settings → Marketplace → Plane.
  2. Click Configure.
  3. Enter your API Key, Workspace Slug, and Project ID.
  4. Click Save & Test.

What gets synced

PwnbookPlane
Task titleIssue title
Task descriptionIssue description
Task statusIssue state (mapped to Plane states)
AssigneeIssue assignee (matched by email)
Due dateIssue due date
When a task is created or updated in Pwnbook, the corresponding Plane issue is created or updated.
Pwnbook stores the Plane issue ID alongside each task to maintain the link. Changes made directly in Plane are not currently synced back to Pwnbook.

Disconnecting

To remove the Plane integration:
  1. Go to Organization Settings → Marketplace → Plane.
  2. Click Disconnect.
  3. Confirm.
Existing Plane issues created by the integration remain in Plane. The Pwnbook task records retain the Plane issue ID field but will no longer sync.