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.
How to create a webhook
- Go to System>Webhooks, then click Create a Webhook.
- Add the
Endpoint URL
you want to send your webhooks to. - Add the webhook
events
that 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.
Alerts:
Action Type | Webhook Trigger |
---|---|
ALERT_CREATED | When an alert is triggered |
ALERT_REOPENED | When an agent re-opens a previously closed alert |
ALERT_CLOSED | When an alert is closed |
ALERT_ACTION_TRIGGERED | When an agent clicks an alert's action buttons |
ALERT_GENERATION_LIMIT_HIT | When the alert generation limit has been hit |
ALERT_COMPONENT_ACTION_TRIGGERED | When alert component action buttons are clicked via the alert detail pane |
Cases:
Action Type | Webhook Trigger |
---|---|
CASE_CREATED | When a case is created |
CASE_REOPENED | When a previously closed case is re-opened |
CASE_CLOSED | When a case is closed |
CASE_ACTION_TRIGGERED | When a case action runs |
Entities:
Action Type | Webhook Trigger |
---|---|
ENTITY_ACTION_TRIGGERED | When an entity action runs (executed from an entity's details pane) |
ENTITY_FLAGGED | When an entity is flagged |
Rules / Models:
Action Type | Webhook Trigger |
---|---|
RULE_TRIGGERED | When a rule is executed |
RULE_CREATED | When an agent deploys a rule |
File Exports:
Action Type | Webhook Trigger |
---|---|
FILE_EXPORT_READY | When an export is ready |
Test your webhook
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.