Skip to main content
System notifications monitor when events or actions occur based on the configured timestamp of an object (e.g contract start) or the time at which an action occurred (e.g. contract created). They’re best for time-based automation workflows around a customer’s key lifecycle events.

​
System notification types

PAYLOAD SCHEMA DIFFERENCESThe payload schema for system notifications differ slightly from the payload schema for threshold notifications. Specifically, the payload for system notifications do not include a properties field. Ensure your webhooks are properly configured to handle both notification types.

​
Webhook payload examples

​
Enabling and managing system notifications

System notifications can be enabled and managed through both the UI and the API.
Notifications list interface showing various notification types and their status
In the UI
  1. Navigate to the Notifications tab
  2. Find the system notification that you’d like to enable. All available system notifications will appear in the notifications list view and be disabled by default for any account
  3. Click on the notification
  4. Click the toggle next to Status to enable
  5. Confirm action to enable
  6. You will begin receiving notifications about this system event for all customers to all configured webhooks
  7. Ensure your webhooks are set up to properly handle the payloads for these notifications
Via API
  1. Call POST /v2/notifications/edit
  2. Pass in the policy of the system notification you’d like to enable (e.g. contract.create) and is_enabled set to true
  3. A successful response will return a 200 response code
HISTORICAL DATA LIMITATIONWhen you enable a system notification, Metronome starts generating events from that point forward. It does not go back and create events for past data. Additionally, the policy for system notifications cannot be edited.