Skip to main content
This example creates a webhook subscription, verifies the signature on each incoming delivery, and handles drift.detected, alert.created, and vulnerability.found events in a Node.js receiver.

Prerequisites

  • A publicly accessible HTTP endpoint (use ngrok for local testing)

Step 1: Create the webhook

The secret is returned only once. Store it immediately in your secrets manager or deployment environment — you cannot retrieve it again.

Step 2: Send a test delivery

Your endpoint should receive a ping event.

Step 3: Implement the receiver (Node.js)

Step 4: Check delivery history

Step 5: Local testing with ngrok

If your receiver runs locally:
Use the ngrok URL as RECEIVER_URL when creating the webhook.
For more on signature verification and retry behavior, see Signature Verification and Retries & Delivery.