Webhooks

Webhooks let SpoofWard send real-time notifications to your own systems when specific events occur. Use webhooks to integrate SpoofWard with your security automation, ticketing systems, or custom dashboards.

Setting Up a Webhook

1. Navigate to Account → Webhooks
2. Click Create Webhook
3. Enter the destination URL (must be HTTPS)
4. Select which events to listen for:
   • Domain scanned — When a DNS health scan completes
   • Forensic report received — When a RUF report is processed
   • Threat detected — When suspicious activity is identified
   • DNS change detected — When DNS records are modified
5. Click Test to send a sample payload
6. Click Save

Webhook Payload

Webhooks send JSON payloads via HTTP POST. Each payload includes:

• Event type
• Timestamp
• Domain and tenant information
• Event-specific data

Managing Webhooks

• Enable/Disable — Pause a webhook without deleting it
• View delivery history — Check if recent deliveries succeeded or failed
• Test — Manually trigger a test delivery
• Delete — Remove the webhook permanently