Skip to content

Discord Integration

Receive BreachSpider CVE alerts as rich embeds in a Discord channel.

!!! info "Tier Requirement" Discord integration requires a Standard plan or above.

Step 1 - Create a Discord Webhook

  1. Open your Discord server
  2. Go to Server Settings > Integrations > Webhooks
  3. Click New Webhook
  4. Name it "BreachSpider" and select the target channel
  5. Click Copy Webhook URL

The URL looks like:

https://discord.com/api/webhooks/1234567890/abcdef...

Step 2 - Add to BreachSpider

  1. Navigate to Integrations > Discord
  2. Click Add Connection
  3. Paste your Discord webhook URL
  4. Select events to receive
  5. Click Test Connection to verify delivery
  6. Click Save

Via API

import requests

api_key = "bs_live_your_key_here"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

connection = {
    "provider": "discord",
    "name": "Security Alerts Channel",
    "config": {
        "webhook_url": "https://discord.com/api/webhooks/...",
        "events": ["kev.new", "cve.critical", "exploit.confirmed"]
    },
    "enabled": True
}

response = requests.post(
    "https://breachspider.com/api/v1/integrations/connections",
    headers=headers,
    json=connection
)
print(response.json())

Discord Embed Format

BreachSpider sends rich embeds with color-coded severity:

  • Red sidebar for critical (CVSS 9+)
  • Orange sidebar for high (CVSS 7-8.9)
  • Yellow sidebar for medium

Example embed fields:

CRITICAL | CVE-2025-32433 | CVSS 10.0
Erlang/OTP SSH Server Unauthenticated RCE

KEV Flagged | PoC Available
BCS: 10.0 | EPSS: Top 5%
Affected: SCADA Middleware Server (Water Plant Alpha)
Patch: Available - OTP-27.3.3

[View in BreachSpider]

Testing the Connection

After saving, click the Test button next to your connection. BreachSpider sends a test embed to your Discord channel. If delivery fails, verify:

  • The webhook URL is correct and not expired
  • The webhook has not been deleted from Discord
  • The target channel still exists

Disconnecting

To remove the Discord integration:

  1. Go to Integrations > Discord
  2. Click the trash icon next to the connection
  3. Confirm deletion

Optionally, delete the webhook in Discord under Server Settings > Integrations > Webhooks.