Skip to main content
A webhook lets the platform call an external URL and send a message with the event information when an event occurs in the organization (an alert, a microservice execution, an operation…). Only a user with the Organization Administrator role can configure it.

​
Create the webhook

  1. Go to Settings → Organization → Webhooks.
  2. Click New.
  3. In Overview, fill in:
    • Name. Name of the webhook.
    • Event type. The event that will trigger it: Alert triggered, Microservice executed, Object created/modified/deleted, Operation executed, or Operation executed on a workspace.
    • Destination URL. Address of the external system that will receive the message.
  4. In Elements, select the specific resources that will trigger the webhook (for example, which alerts or which microservices), or enable the Send webhook for all option for the corresponding type.
  5. In Message configuration, define the JSON template that will be sent. Variables (for example #workspace_name or #alert_name) are automatically replaced with the actual value when the event occurs.
  6. Click Save.
Avoid creating two webhooks with the same configuration. Doing so can generate duplicate submissions.

​
Test the webhook

From the detail view, the Test action sends a message with the template content (without replacing the variables) to the configured URL. This lets you validate connectivity and format without waiting for the actual event to occur.

​
Related information

For the full list of variables available by event type, template examples for Slack and Microsoft Teams, and details on delivery retries, see Webhooks.