Links

Webhooks

Configuring the location webhooks

Location Webhook

You can sync location data to and from external third-party software/APIs using webhooks for various trigger events.

Location Webhook Settings

The Location Webhook settings is for the outgoing data from your MangoApps domain to external third-party software/APIs.
Admin Portal > Domain > Locations > Webhook > Location Webhook
  1. 1.
    Select Trigger Events: Mark the trigger events to push data to external third-party software/APIs. You can choose triggers for Create Location, Update Location, and Delete Location events. The system pushes data whenever the marked trigger takes place on your domain.
  2. 2.
    Post to URL: Specify the external third-party software/APIs URL to push and sync the locations data to an external server or data source.
  3. 3.
    Request Parameters: Enter the external system ID for request parameters in the API Field text box and select the MangoApps location 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.
  4. 4.
    Response Parameters: Enter the external system ID for response parameters in the API Field text box and select the MangoApps location 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.
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 locations.

Notifying MangoApps Settings

The Notifying MangoApps settings is for the incoming data from external third-party software/APIs into your MangoApps domain.
Admin Portal > Domain > Locations > Webhook > Notifying MangoApps
  1. 1.
    MangoApps URL: The MangoApps URL you can use to push and sync the locations data from your server or data source.
  2. 2.
    Input Parameters: Enter the external system ID for input parameters in the API Field text box and select the MangoApps location field from the MangoApps Field drop-down and mark the Location 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.
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 locations and the configuration of the webhooks.

Security Settings

Admin Portal > Domain > Locations > Webhook > Setup Security
  1. 1.
    To setup OAuth based authentication: Click the Webhook Security link to configure the OAuth based authentication for your MangoApps domain.
Did this article help? Your feedback adds value when we shape up the help articles. Hit the smiley
below to let us know!