# 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.


---

# 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/integrations/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.