Skip to main content

Integrations

Overview

Faultlean can publish reports to an issue tracker and a messaging platform. When you click "Publish" on a report, the full report content — description, reproduction steps, reviews, messages, and attachments — is sent to the configured services.

Integration settings are available to organization owners under Settings > Integrations.

Linear (Issue Tracker)

Linear is used to create issues from published reports and track their triage status.

Setup

  1. In Linear, go to Settings > API and create a personal API key (or a service account key with write access).
  2. In Faultlean, go to your organization's Integrations page.
  3. Select "Linear" as the issue tracker.
  4. Enter your API key.
  5. Enter your team identifier — this can be the team key (e.g. SECDEV), the team UUID, or the full team name. If left blank, issues go to the first team in your workspace.

Label Group

If you use a label group in Linear to track triage status (e.g. "Security Triage" with labels like Verified, Fix in progress, Fixed), enter the label group name in the "Label Group" field. Faultlean will display the current triage label on the report page when viewing a published report.

What Gets Published

When you publish a report, Faultlean creates a Linear issue containing:

  • Report title and number
  • A link back to the report in Faultlean
  • Reporter name and suggested severity
  • Description, reproduction steps, and impact (with inline images uploaded to Linear)
  • File attachments (uploaded to Linear)
  • Reviews with classification flags
  • Messages (including internal messages)

When you republish, a comment is added to the existing Linear issue with the updated content.

Slack (Messaging Platform)

Slack is used to post a notification when a report is published.

Option 1: Bot Token (recommended)

Using a Slack bot token gives you message permalinks — Faultlean stores the link to the Slack message so you can navigate directly to it.

  1. Go to api.slack.com/apps and create a new app for your workspace.
  2. Under OAuth & Permissions, add the chat:write scope.
  3. Install the app to your workspace.
  4. Copy the Bot User OAuth Token (starts with xoxb-).
  5. In Slack, invite the bot to your channel: type /invite @YourBotName in the channel.
  6. Get the channel ID: open channel details in Slack and copy the ID at the bottom (e.g. C0AL901HSGG). Private channels require the channel ID, not the channel name.
  7. In Faultlean, enter the bot token and channel ID on your organization's Integrations page.

Option 2: Webhook (fallback)

If you do not need message permalinks, you can use an incoming webhook instead.

  1. In your Slack workspace, go to Apps > Incoming Webhooks (or create one at api.slack.com/apps).
  2. Create a webhook for the channel where you want notifications.
  3. Copy the webhook URL (starts with https://hooks.slack.com/).
  4. In Faultlean, enter the webhook URL on your organization's Integrations page.

Webhook messages are fire-and-forget — Faultlean cannot retrieve a permalink to the posted message.

What Gets Posted

The Slack message includes the report title and severity, with links to view the report in Linear (if published there) and in Faultlean.