# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.mangoapps.com/admin-guide/domain-settings/locations/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.