# About webhooks

Webhooks allow you to build or set up integrations which subscribe to certain events on Airlock. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to forward data to your existing analysis stack, or respond to security events within your organization's infrastructure. You're only limited by your imagination.

Webhooks can be installed on a per group basis. Once installed, the webhook will be sent each time one or more subscribed events occurs.

You can create up to 1 webhook per group.

# Events

When configuring a webhook, you can use the UI or API to choose which events will send you payloads. Only subscribing to the specific events you plan on handling limits the number of HTTP requests to your server. You can also subscribe to all current and future events. By default, webhooks are not subscribed to any events. You must turn on webhooks by first subscribing to an event.

Each event corresponds to a certain set of actions that can happen to your group. For example, if you subscribe to the alert event you'll receive detailed payloads every time an alert is open, closed, etc.