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.

To enable a webhook to send payloads using OAuth client credentials:

Note

The OAuth client credentials only work with the Salesforce Connector.

  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. Add the endpoint you want to receive payloads to the Endpoint field.

  9. Select the following webhook events from Enabled events.

    Note

    Only the following webhook events will process. The Salesforce Connector will ignore any other selected webhook events.

    • Product badge changed

    • Product status changed

    • Risk level changed

  10. 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 one at a time in the order they were triggered.

Additional information