Skip to main content

Overview

This document outlines the steps necessary to deliver the platform's external notifications to an HTTP endpoint through the Webhook Notification Provider, for example to a ticketing system, a chat tool or an automation pipeline.

Webhook Notification Provider​

The Webhook Notification Provider is the Connector that implements the Notification Provider interface for HTTP delivery:

Function GroupKind
Notification ProviderWEBHOOK

When an event triggers a notification profile that uses an instance of this connector, the connector sends an HTTP POST request to the URL of the instance. The body is the whole notification request as JSON, or is rendered from a template, see content types.

Every request carries these headers:

HeaderValue
Content-TypeAccording to the content type of the instance
X-Webhook-TimestampTime of the request in milliseconds since the epoch
X-Webhook-NonceRandom Base64-encoded value, unique per request

Delivery is not confirmed to the platform: the connector accepts the notification before the request completes, and a request that fails or is answered with an error is logged by the connector and not retried.

The webhook posts to its URL whatever the recipients of the notification are, so profiles that use it typically have the recipient type None, see notification recipients. Recipients that a profile does resolve are part of the delivered request.

Prerequisites​

Before you start, make sure that:

  • The Webhook Notification Provider is deployed and registered as a Connector in the platform. Deploying the connector is part of the installation: with the Helm chart, set webhookNotificationProvider.enabled in the chart values; with the operator, deploy it with a Connector resource.
  • To include event data in the requests, the connector is version 1.1.0 or later.
  • The receiving endpoint is reachable from the connector and accepts POST requests with the content type you choose.

Integration​

The following steps are required to deliver notifications to an HTTP endpoint:

#ReferenceShort description
1Configure Notification InstanceCreate the notification instance with the URL and the content type
2TemplatesWrite the request body, for the JSON and XML content types
3Send Notifications on EventsUse the instance in a notification profile, and send the profile from a trigger on the events to notify about