Webhooks

Webhooks provide real-time, event-driven communication between RiskOS™ and your applications. When specific events occur in RiskOS™ (such as evaluation completions, decision changes, or case updates), HTTP POST requests are automatically sent to your configured endpoints with relevant event data.

Get started

Set up webhooks

Create, test, and manage webhook endpoints in the RiskOS™ Dashboard.

Webhook event reference

Explore all event types with payload schemas and example responses.

Webhook configuration reference

Authentication schemes, delivery requirements, retry behavior, and IP allowlisting.

Troubleshoot webhooks

Fix common issues with delivery failures, authentication errors, and FAQs.

Event quick reference

Event type	Category	Description
`evaluation_completed`	Evaluation	Evaluation processing completed
`evaluation_paused`	Evaluation	Evaluation processing paused
`reevaluation`	Evaluation	Case reevaluated
`workflow_execution_failed`	Evaluation	Evaluation execution failed
`decision_update`	Case Management	Decision updated in Case Management
`fraud_confirming`	Case Management	Case marked as fraud or non-fraud
`review_case_assigned`	Case Management	Case assigned to a reviewer
`review_case_unassigned`	Case Management	Case unassigned from a reviewer
`case_status_updated`	Case Management	Case status updated
`case_notes_added`	Case Management	Notes added to a case
`case_attachment_added`	Case Management	Attachments added to a case

For full payload schemas and examples, see the webhook event reference.

Product-specific webhooks

Watchlist webhooks

Event notifications for Watchlist matches and updates.

Predictive DocV webhooks

Asynchronous Document Verification events for capture, upload, and decisions.