Supported events
| Event | Description | Payload includes |
|---|---|---|
url.scanned | A URL batch scan has completed | Batch ID, verdicts, risk factors per URL |
email.scanned | An email scan has completed | Address, verdict, detection details |
document.scanned | A document scan has completed | File ID, verdict, threat details |
brand.impersonation | A lookalike domain has been detected | Monitor ID, detected domain, detection type |
Configuration
- 1 Go to Settings > Webhooks in your dashboard
- 2 Click Add endpoint and enter your HTTPS URL
- 3 Select the events you want to receive
- 4 Save — Verifence will immediately start sending events
Reliability
Failed webhook deliveries are logged in the dashboard with the full request and response. Verifence retries failed deliveries automatically. If an endpoint fails repeatedly, the webhook is temporarily disabled and you are notified. View full delivery history from the Webhooks dashboard.
Payload format
All webhook payloads are JSON objects delivered via HTTP POST. Each payload includes the event type, timestamp, and the full scan result — the same data returned by the API. Secure your endpoint by verifying the X-Verifence-Signature header included with every delivery.
Typical use cases
- ✓Block a file upload when document.scanned returns a threat verdict
- ✓Reject a signup or flag an account when email.scanned returns Block
- ✓Post a Slack alert when brand.impersonation fires
- ✓Open an incident ticket in your SIEM when url.scanned returns Block