Webhook Management

Receive real-time notifications when events occur in your workspace

No Webhooks Configured

Set up webhooks to receive real-time notifications when searches complete, trends are detected, or content gaps are identified.

Webhook Payload Format

POST your-endpoint-url
Content-Type: application/json
X-Webhook-Signature: sha256=<hmac_hex>
X-Webhook-Event: strategy.finalized
X-Webhook-Timestamp: 2026-03-10T12:00:00.000Z

{
  "event": "strategy.finalized",
  "timestamp": "2026-03-10T12:00:00.000Z",
  "data": {
    "searchId": 123,
    "term": "best crm software",
    "totalNodes": 42,
    "intents": { "informational": 18, "commercial": 12, ... }
  }
}

Signature Verification (Node.js)

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}
strategy.finalizedTriggered when a PAA keyword search completes
trend.detectedTriggered when TrendSpark finds a trending topic
gap.identifiedTriggered when content gap analysis completes
quota.lowTriggered when tenant quota drops below 20%