> 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
Two-way integration to keep the user profile data in sync with your company's HRMS system.
### 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.
***
### 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**.
**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.
**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.
