Ascend includes a notification system to alert operators on events occurring in the platform. Notifications are configured per Data Service and are sent as a webhook. Each Data Service contains multiple webhooks, each of which can customize:

• The webhook endpoint
• Body, templatized through "Handlebars" syntax
• HTTP headers
• Which Platform Events to subscribe to

The customizability of Ascend's notification system allows for integrating with most common alerting systems, like PagerDuty and OpsGenie, as well as custom webhook processors.

Platform Event Categories

The full list of Platform events is broken down into different categories of the Ascend API and which Ascend entities the events apply to.

Payload Template

Ascend will send a default JSON HTTP body in the webhook for the event subscription. However, each endpoint may customize the body through through "Handlebars" syntax.

The payload is rendered with an "event" variable, enabling a dynamic webhook body. Below is an example of creating a JSON formatted body using a few different variables.

{
  "fields": {
    "Email": "{{event.user.email}}",
    "Action": "{{event.type}}",
    "Time": "{{event.event_time}}",
    "Environment": "{{event.environment}}"
  }
}

The Webhook Notification Event Variable reference documentation contains the full list of fields available.