Webhooks are notifications that Unit21 sends when an event occurs on your platform.
From the Webhooks pane of the Unit21 UI, you can configure what events trigger a webhook, along with the endpoints where notifications are sent.
For example, this webhook sends notifications about any alert activity to a specially designated endpoint.
- Go to System>Webhooks, then click Create a Webhook.
- Add the
Endpoint URLyou want to send your webhooks to.
- Add the webhook
eventsthat trigger your webhook. For a description of the events, see the event reference in the following section.
The following list outlines the objects available for Unit21 webhooks, and briefly describes the events that trigger each webhook.
When an alert is triggered
When an agent re-opens a previously closed alert
When an alert is closed
When an agent clicks an alert's action buttons
When alert component action buttons are clicked via the alert detail pane
When a case is created
When a previously closed case is re-opened
When a case is closed
When a case action runs
When an entity action runs (executed from an entity's details pane)
When an entity is flagged
When a rule is executed
When an agent deploys a rule
When an agent runs a rule action
When an agent selects an event action button
When a verification workflow is executed
When entity verification is completed
When verification initiations for an entity
When verification returns the state "manual review needed"
When verification is approved
When verification is rejected
After you create a webhook, you can send a test request. If a request fails, Unit21 tries to resend the webhook. However, Unit21 sends a maximum of three requests.