Configure Webhook listeners

Configure webhook listeners (also known as HTTP push API) to enable your microapps to provide near real-time data to your end users. Configuring a webhook allows your apps to deliver data to other applications at a much quicker rate than synchronization from the Microapp platform side. The maximum size of a webhook request body that can be handled by MA server is 64kb.

Adding webhook listeners requires you to be familiar with your target application System of Record and have the necessary tools and administration privileges set up to configure your webhooks in those locations.

Configure your webhooks after you have set up your integration via Data Loading and follow these steps:

  1. Click Webhook Listeners on the left hand bar of the HTTP Integration screen:

    Webhook listeners

  2. Enter your desired webhook name.
  3. Select Copy to copy the webhook URL for use in your target System of Record administration interface.

Authorization method

You can select either the Token authorization method or None when configuring your authorization method. To configure the token method follow these steps:

  1. Select Token in the Authorization method menu.
  2. Select Generate token and then select Copy to add the token to your clipboard for use in your target System of Record administration interface.
  3. Select read token from to choose from:

    • Custom header
    • Query parameter
    • Authorization header
  4. Define either the Name or the Prefix depending on your selected read method.

The token is now set up.

Define data structure

You can define your data structure in a similar method described when you Fetch data structure during Data Loading configuration. For more information see Configure the integration.

To define your webhook data structure follow these steps:

  1. Set your desired data retention period. All entries that are older than this date are deleted. Each saved entry contains its date and time of modification. That is lastModified. This date and time is used to decide which entries to delete.
  2. Select Generate Tables.

    The Generate Tables screen opens.

    Paste your JSON sample request from your target application System of Record here.

  3. Set your base name of created tables.
  4. (Optional) set the root path if necessary.
  5. Select Generate.

With this process complete alongside the configuration measures completed in your target application System of Record administration, select Add.

Your webhook is now configured.

Show Webhook logs

Use Webhook logs to view a history of requests and errors from all webhook endpoints. You can filter by webhook name and state, such as success, error, or all.

  1. From the Manage Microapps page, select the menu next to the integration that you want to view integration logs for.
  2. Select Webhook logs.
  3. Review the entries, and select from the menu to filter as required.

Configure Webhook listeners