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


---

# 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/module-settings/people/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.
