Set up a generic webhook integration

Contrast supports a generic webhook integration to receive notifications on any URL that receives POST messages. The simple integration format includes an optional Payload field where you can include a titlemessage, and other fields.

To connect a generic webhook:

  1. Retrieve the URL from which you want Contrast to receive notifications.

  2. In the user menu, select Organization settings > Integrations.

  3. In the Generic webhook integration option, select Connect.

  4. Name the webhook, and paste the URL in the designated field.

  5. Select the application(s) that you want to filter.

  6. In the Payload field, enter a payload. For example:

    {
        'title': $Title,
        'message': $Message
    }
  7. Select Save.

Note

If this webhook fails to return a successful response after 5 attempts, it will be disconnected. To restore the configuration, you must retest the connection and resave it.

You can configure the integration so that all organization administrators are notified in the Contrast application and by email when Contrast disconnects a generic webhook.

To do this, go to the same location: Organization settings > Integrations > Generic Webhook > Show configurations. Select the name of the connection you want to configure. Then select the box to receive notifications and click Save.

Notify on disconnect. If this webhook fails to return a successful response after 5 attempts, it will be disconnected. All organization administrators will be notified in Contrast and by email.