API Reference

Webhooks for Insights

In Summary

Webhooks allow you to set up a notification system that can be used to receive updates on certain requests made to the Insights API endpoints.

How it works

  1. Webhooks require an https URL without any sort of authentication set to POST.

  2. A 32 bit secret key is also required by the webhook for encryption and decryption purposes.

  3. Webhook also contains an HMAC message that is hashed using an HmacSha512 algorithm with the 32 bit secret key so you can hash the particular response object and compare the received hash with your hashed response to check if the
    response has been altered.

Types of Webhook responses

There are 3 types of webhook responses;

Using this approach you can identify what response was sent, then hash the response and compare both to check if the message was altered.