> 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/integrations/webhooks.md).

# Webhooks

### Overview

MangoApps becomes even more powerful when it can integrate with the external tools your team uses every day. The **Webhooks Integration Module** allows you to automatically pull in data and activity from other systems into MangoApps — ensuring your team has access to timely, relevant, and searchable information, all in one place.

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

***

### OAuth Authentication Setup

Before setting up the webhooks, you’ll first need to configure authentication credentials that MangoApps will use to connect with your external system.

1. **Enter the OAuth Token URL**\
   Provide the URL used to retrieve the OAuth token.
2. **Input the Username**\
   Enter the username credential if required by your OAuth configuration.
3. **Enter the Password**\
   Enter the password credential.
4. **Click Save**\
   Save your OAuth configuration to enable secure webhook communication.

{% hint style="info" %}
Ensure your external systems can handle OAuth authentication as configured.
{% endhint %}

***

### Webhook Configuration Options

You can set up webhooks for:

* **Users**
* **Locations**

#### Users Webhook

The Users Webhook allows you to sync user data between MangoApps and your external systems. This includes options for automatic user creation using **JIT (Just-In-Time) Provisioning**.

<div align="center"><img src="/files/sZ7AZQAGjKvfiRQYigsJ" alt=""></div>

**Select the Trigger Event**\
Choose which user actions should trigger the webhook:

* Create User
* Update User Profile
* Activate/Deactivate User

**Enter the URL to Post to**\
Specify the external endpoint where MangoApps will send the webhook data.

**Configure the Request Parameters**

* Map the fields from MangoApps to your external system.
* Ensure each MangoApps field corresponds correctly to your external fields for accurate data syncing.

**Configure the Response Parameters**

* Use the same process as above to ensure response data is correctly mapped back into MangoApps.

**Configure the Input Parameters**

* Set up the input fields that MangoApps should listen for when receiving updates from your external system.

**JIT Provisioning (Optional)**

* If enabled, JIT allows MangoApps to automatically create user accounts as users log in for the first time, using the data received from your identity provider or external system.

***

#### Locations Webhook

The Locations Webhook keeps your office location data in MangoApps synced with your external systems.

<div align="center"><img src="/files/ZTi3eyBsCFQhap097hMn" alt=""></div>

**Select the Trigger Event(s)**\
Choose one or more location actions:

* Create Location
* Update Location
* Delete Location

**Enter the URL to Post to**\
Provide the endpoint where MangoApps should send location data.

**Configure the Request Parameters**

* Map each request parameter from MangoApps to the appropriate fields in your external system.

**Configure the Response Parameters**

* Similar to request parameters, map any response data fields to MangoApps fields.

**Enter Input Parameters**

* Define which fields MangoApps should update based on the information received from your external system.