Skip to main content
Corgea’s Slack integration allows you to receive notifications in your Slack workspace when scan events occur using Slack’s Workflow Builder and Corgea webhooks.

Prerequisites

Before setting up the integration, ensure you have:
  • Administrative access to your Corgea account
  • Appropriate permissions in your Slack workspace

Setting Up Slack Workflow Builder

This method provides flexibility by allowing you to create custom workflows that can route notifications to different channels or trigger other automated actions.
1

Create a Workflow

  1. In Slack, click on your workspace name
  2. Select “Tools” → “Workflow Builder”
  3. Click “Create” to start a new workflow
  4. Select “Webhook” as the trigger
  5. Give your workflow a name and click “Next”
2

Configure Workflow Steps

  1. After creating the webhook, copy the provided Webhook URL
  2. Add steps to your workflow (e.g., “Send a message”)
  3. Configure the message format using variables from the webhook payload
Corgea sends scan completion notifications through the scan.completed webhook event. Here’s an example payload:
{
  "event_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "event_type": "scan.completed",
  "timestamp": "2025-01-15T15:45:00.000Z",
  "data": {
    "company": "comp-uuid-1234",
    "scan_id": "scan-uuid-7890",
    "project": {
      "id": "proj-uuid-9012",
      "name": "My Project"
    },
    "summary": {
      "total_issues": 10,
      "issues_with_fixes": 6,
      "issues_without_fixes": 4
    }
  }
}
You can create your own Slack message using variables from the webhook payload.
  1. Click “Add a Step” and then select “Finish Up”
    • Sending messages to multiple channels
    • Creating reminders
    • Updating channel topics
    • Integrating with other Slack apps
  2. Make sure the workflow details and permission are correct before publishing.
3

Configure in Corgea

  1. Log in to your Corgea account and go to “Integrations”
  2. Open “Webhooks” and create a new webhook
  3. Set the type to Slack
  4. Enter a name for the integration
  5. Paste the Workflow Webhook URL
  6. Subscribe to scan.completed
  7. Click “Save”
  8. Click “Test” to ensure the integration is working

Notification Content

Corgea sends scan details in the scan.completed webhook payload, including:
  • Scan ID
  • Project name
  • Total issue count
  • Issue fix counts
  • Severity and classification breakdowns

Customization Options

With Workflow Builder, you can:
  • Create conditional logic for different types of notifications
  • Route messages to different channels based on severity
  • Trigger custom automations based on scan results
  • Integrate with other Slack workflows and apps
  • Use variables to customize message format and content

Additional Resources

By configuring the Workflow Builder integration, you can ensure your team stays informed about security scan results and take advantage of Slack’s automation capabilities for a more streamlined security workflow.