> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure a webhook

> How to create a webhook integration to notify an external tool when an event occurs in the organization.

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**.

> [!WARNING]
>
> 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](https://docs.flexxible.com/en/features/integrations/webhooks.md).