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 It as a BreachSpider Webhook

Discord is delivered through BreachSpider's outbound webhooks. When a webhook URL is a Discord webhook URL, BreachSpider sends a Discord-formatted embed instead of the standard JSON payload.

  1. Navigate to Integrations > Webhooks
  2. Click Add Webhook
  3. Enter a label and paste your Discord webhook URL
  4. Click Test to verify delivery
  5. Click Save

Alerts are sent for newly published CVEs that match your watchlist or your assets. See How Alerts Work for exactly what is and is not alerted.

Via API

import requests

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

webhook = {
    "label": "Security Alerts Channel",
    "url": "https://discord.com/api/webhooks/..."
}

response = requests.post(
    "https://breachspider.com/api/v1/webhooks",
    headers=headers,
    json=webhook
)
print(response.json())

Discord Embed Format

Each alert is one embed:

  • Title: [PRIORITY] CVE-ID, where priority is PATCH NOW, PATCH NEXT, MONITOR, or IGNORE
  • Color: red for PATCH NOW, orange for PATCH NEXT, blue otherwise
  • Description: the CVE title, linked to the CVE page
  • Fields: CVSS Score, Patch Status, KEV (known-exploited or not), and an AI summary when available

Testing the Connection

After saving, click the Test button next to your webhook. 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 > Webhooks
  2. Click the trash icon next to the webhook
  3. Confirm deletion

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