Skip to main content

Configure webhooks

Prerequisites

You must have Read and write permission for Webhook config in the Developer tools.

To enable a webhook to send payloads using a Bearer token:

  1. Go to Manage account > Webhook config.

  2. Select Activate webhooks.

  3. If you would like webhooks to be sent in batches, select Activate batching. We recommend activating batching.

  4. Select Bearer token from the Auth type drop-down menu.

  5. Add your secret to the Shared secret field. Ensure that your integration checks the secret when webhook payloads are received. This will make sure a malicious third party can't intercept the payload and provide you with false information.

  6. Add the endpoint you want to receive payloads to the Endpoint field.

  7. Select the webhook events you want to listen to from Enabled events. You can select as many as you like.

  8. Select Save.

Webhooks are generated in the order events occur, and each payload includes a UNIX timestamp. However, we can't guarantee that webhooks are delivered in the same order they were triggered. Network conditions, retries, and batching can affect the delivery sequence.

  1. Go to Manage account > Webhook config.

  2. Select Activate webhooks.

  3. If you would like webhooks to be sent in batches, select Activate batching. We recommend activating batching.

  4. Select OAuth client credentials from the Auth type drop down menu.

  5. Add your Client ID to the Client ID field.

  6. Add your secret to the Client secret field. Ensure that your integration checks the secret when webhook payloads are received. This will make sure a malicious third party can't intercept the payload and provide you with false information.

  7. Add your Token URL to the Token URL field.

  8. Optionally, add scope values to the Scopes field to define the scopes for your OAuth client credentials. This field accepts space-separated values, for example, "read write admin", and passes them through the scope parameter during the OAuth client credentials flow.

  9. Add the endpoint you want to receive payloads to the Endpoint field.

  10. Select the following webhook events from Enabled events.

    Note

    Only the following webhook events will process for the Moody's Maxsight for Salesforce. It will ignore any other selected webhook events.

    • Product badge changed

    • Product status changed

    • Risk level changed

  11. Select Save.

Batching

When batching is enabled, multiple webhooks are delivered in a single request.

Webhook messages are added to a queue and Maxsight delivers the first 100 messages in the queue approximately every 0-10 seconds.

We recommend that high-volume clients enable batch processing. Without batching, webhooks are sent individually as they are triggered.

Additional information