> For the complete documentation index, see [llms.txt](https://guides.mangoapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.mangoapps.com/admin-guide/domain-settings/locations/webhooks.md).

# Webhooks

### Overview

Webhooks enable synchronization of office location data between MangoApps and external third-party software/APIs. With webhooks, admins can send or receive location-related updates based on specified trigger events. 

***

### Location Webhook Settings (Outgoing Data)

The **Location Webhook** settings allow MangoApps to push location data to external third-party software/APIs.

<figure><img src="/files/MOZJAb9CAhAzImi4qOwT" alt="" width="563"><figcaption></figcaption></figure>

#### **Configuring Location Webhook**

**Select Trigger Events:**

* Choose the events that should trigger the webhook:
  * **Create Location** – Triggers when a new location is created.
  * **Update Location** – Triggers when an existing location is updated.
  * **Delete Location** – Triggers when a location is removed.
* The system will send data to the specified external server whenever the selected event occurs.

**Post to URL:**

* Enter the endpoint URL of the external third-party software/API where the location data should be sent.

**Request Parameters:**

* Define the request parameters to send data to the external system.
* Steps:
  * Enter the external system’s API field name in the **API Field** text box.
  * Select the corresponding MangoApps location field from the **MangoApps Field** drop-down menu.
  * Click **+ Add** to add more request parameters.
  * Click **Remove** to delete any unnecessary parameters.

**Response Parameters:**

* Configure response parameters to receive confirmation or additional data from the external system.
* Steps:
  * Enter the external system’s response field in the **API Field** text box.
  * Select the appropriate MangoApps field from the **MangoApps Field** drop-down menu.
  * Click **+ Add** to include more response parameters.
  * Click **Remove** to delete response parameters if necessary.

{% hint style="warning" %}
Ensure the **external system ID** for both request and response parameters matches the third-party API field for locations.
{% endhint %}

***

### Notifying MangoApps Settings (Incoming Data)

The **Notifying MangoApps** settings enable external third-party software/APIs to send location data to MangoApps.

<figure><img src="/files/BsXHMJV2Sdgz0emMus3u" alt="" width="563"><figcaption></figcaption></figure>

#### **Configuring Notifying MangoApps**

**MangoApps URL:**

* Use the provided MangoApps URL to send and sync location data from an external server.

**Input Parameters:**

* Define the parameters MangoApps will receive from the external system.
* Steps:
  * Enter the external system’s API field in the **API Field** text box.
  * Select the matching MangoApps location field from the **MangoApps Field** drop-down menu.
  * Check the **Location Identifier** checkbox if the parameter is a unique identifier.
  * Click **+ Add** to add more input parameters.
  * Click **Remove** to delete an input parameter.

{% hint style="warning" %}
The **external system ID** for input parameters must match the third-party API field for proper data synchronization.
{% endhint %}