> For the complete documentation index, see [llms.txt](https://docs.alemba.com/asm-gaia-10.4/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.alemba.com/asm-gaia-10.4/integrate/managing-integration/webhooks.md).

# Webhooks

Webhooks allow external services to be notified when certain events happen. When the specified events happen, we’ll send a POST request to each of the URLs you provide.

Webhooks are user-defined HTTP callbacks. They are triggered by some event in a web application and can facilitate integrating different applications or third-party APIs, like Microsoft Project, Smart Sheets, or even social networking applications.

{% hint style="warning" %}
**Before you Start**

You should have Integration rights in your General Access Security role.

You should be familiar with Webhook configuration, payload configuration, and the integration platform.  Alemba recommends you seek the assistance of your professional services team when planning to configure your webhooks if you have never configured them before.
{% endhint %}

### Add a Webhook

When creating a webhook, you are specifying a payload, that is the message and data, that is sent when the triggering event is met.  To add a webhook:

1. Click the Add a Webhook button
2. Enter the following:
   * [ ] Payload URL
   * [ ] Secret
   * [ ] Select an entity type for the web hook.  You can select from Call, CMDB item, Person, Request, or Task.
   * [ ] Enter the columns to include in the payload, by default, all columns will be included.
   * [ ] Enter a payload filter that specifies what payloads should be sent, if necessary.  
   * [ ] If you are ready to turn it on, tick the Active checkbox.
   * [ ] Click the Add Webhook button to save your changes.