> 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/module-settings/people/webhooks.md).

# Webhooks

## Overview <a href="#location-webhook" id="location-webhook"></a>

Use the Profile Webhook feature to enable seamless integration and synchronization of profile data between MangoApps and external third-party software or APIs. By utilizing webhooks triggered on events like user creation, profile updates, or user activation/deactivation, companies can ensure that critical user information remains consistent and up-to-date across different platforms. This capability streamlines data management processes, enhances interoperability between systems, and ultimately improves efficiency by automating data exchanges without manual intervention. Additionally, the ability to configure security settings, including OAuth-based authentication, ensures data integrity and confidentiality during these exchanges, meeting stringent security requirements for modern enterprise IT infrastructures.

***

### Profile Webhook Settings <a href="#location-webhook-settings" id="location-webhook-settings"></a>

The Profile Webhook settings are for the **outgoing** data from your MangoApps domain to external third-party software/APIs.

<img src="/files/d93z37gHmAai227MebyH" alt="Admin Portal > Modules > People > Webhooks > Profile Webhook" width="563">

**Select Trigger Events**

Mark the trigger events to push data to external third-party software/APIs. You can choose triggers for Create User, Update User Profile, and Activate/Deactivate User events. The system pushes data whenever the marked trigger takes place on your domain.

**Post to URL**

Specify the external third-party software/APIs URL to push and sync the profile data to an external server or data source.

**Request Parameters**

Enter the external system ID for request parameters in the API Field text box and select the MangoApps profile field from the MangoApps Field drop-down to map the data. Click the **+ Add** button to add more request parameters and click the **Remove** button to remove a request parameter.

**Response Parameters**

Enter the external system ID for response parameters in the API Field text box and select the MangoApps profile field from the MangoApps Field drop-down to map the data. Click the **+ Add** button to add more response parameters and click the **Remove** button to remove a response parameter.

{% hint style="warning" %}
The external system ID for the request and response parameters **MUST** match your third-party API field for successful exchanges. Refer your third-party API specifications for the API fields for user profiles.
{% endhint %}

***

### Notifying MangoApps Settings <a href="#notifying-mangoapps-settings" id="notifying-mangoapps-settings"></a>

The Notifying MangoApps settings are for the **incoming** data from external third-party software/APIs into your MangoApps domain.

<img src="/files/sAka4zWQ9tJxaJQp7Bq6" alt="Admin Portal > Modules > People > Webhooks > Notifying MangoApps" width="563">

**MangoApps URL**

The MangoApps URL you can use to push and sync the profile data from your server or data source.

**Input Parameters**

Enter the external system ID for input parameters in the API Field text box and select the MangoApps profile field from the MangoApps Field drop-down and mark the User Identifier check box to map the data. Click the **+ Add** button to add more input parameters and click the **Remove** button to remove an input parameter.

{% hint style="warning" %}
The external system ID for the input parameters **MUST** match your third-party API field for successful exchanges. Refer your third-party API specifications for the API fields for user profiles and the configuration of the webhooks.
{% endhint %}

***

### &#x20;Security Settings <a href="#security-settings" id="security-settings"></a>

To setup OAuth based authentication click the [**Webhook Security**](https://guides.mangoapps.com/admin-guide/integrations/webhooks) link to configure the OAuth based authentication for your MangoApps domain.