Configuring Webhooks

Overview

Webhooks send real-time notifications to your systems when events occur in Bleach. Use them to trigger automated workflows.

Step 1: Create Webhook

1. Navigate to Settings → Webhooks
2. Click "Create Webhook"
3. Enter your endpoint URL
4. Name the webhook

Step 2: Select Events

Choose which events trigger the webhook:

• issue.created - New security issue detected
• issue.resolved - Issue marked as resolved
• scan.completed - Security scan finished
• alert.triggered - Alert condition met
• compliance.changed - Compliance status change

Step 3: Configure Security

1. Generate a signing secret
2. Use the secret to verify webhook authenticity
3. Configure retry settings
4. Set timeout values

Step 4: Test and Activate

1. Click "Send Test Event"
2. Verify your endpoint receives the payload
3. Check response handling
4. Activate the webhook

Payload Format

{
  "event": "issue.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "issue_123",
    "severity": "high",
    "title": "MFA Not Enabled",
    "affected_user": "user@example.com"
  }
}

Monitoring

• View webhook delivery logs
• Check success/failure rates
• Review failed deliveries
• Manually retry failed events