v10

latestOpenAPI 3.0.1raw.githubusercontent.com2025-12-033223581.2 MB

Notifications

Create Notification

Create a new Notification for an Event.

This endpoint enables you to create a new Event Notification for the specified Organization. You need to supply a request body with the details of the new Notification.

post/organizations/{orgId}/notifications/configurations

Path parameters

orgIdstring required

The unique identifier (UUID) of your Organization. The Organization represents your company as a direct customer of our service.

Request body

versioninteger

The version number of the entity:

Create entity: Not valid for initial insertion of new entity - do not use for Create. On initial Create, version is set at 1 and listed in the response.
Update Entity: On Update, version is required and must match the existing version because a check is performed to ensure sequential versioning is preserved. Version is incremented by 1 and listed in the response.

Response

Returns the created Notification

idstring required

The UUID of the entity.

versioninteger

The version number:

Create: On initial Create to insert a new entity, the version is set at 1 in the response.
Update: On successful Update, the version is incremented by 1 in the response.

dtCreatedstring date-time

The DateTime when this item was created (in ISO-8601 format).

dtLastModifiedstring date-time

The DateTime when this item was last modified (in ISO-8601 format).

createdBystring

The ID of the user who created this item.

lastModifiedBystring

The ID of the user who last modified this item.

namestring required

The name of the Notification.

descriptionstring required

The description for the Notification providing a brief overview of its purpose and functionality.

activeboolean

A Boolean flag indicating whether or not the Notification is active.

TRUE - active Notification.
FALSE - inactive Notification.

alwaysFireEventboolean

A Boolean flag indicating whether the Notification is always triggered, regardless of other conditions and omitting reference to any calculation. This means the Notification will be triggered simply by the Event it is based on occurring and with no further conditions having to be met.

TRUE - the Notification is always triggered and omits any reference to the calculation to check for other conditions being true before triggering the Notification.
FALSE - the Notification is only triggered when the Event it is based on occurs and any calculation is checked and all conditions defined by the calculation are met.

eventNamestring

The name of the Event that the Notification is based on. When this Event occurs and the calculation evaluates to True, the Notification is triggered.

Note: If the Notification is set to always fire, then the Notification will always be sent when the Event it is based on occurs, and without any other conditions defined by a calculation having to be met.

calculationstring

A logical expression that that is evaluated to a Boolean. If it evaluates as True, a Notification for the Event is created and sent to the configured destination. Calculations can reference numeric, string, and boolean Event fields.

See Creating Calculations in the m3ter documentation for more information.

codestring required

The short code for the Notification.

Example response

{
  "name": "Commitment has under 10% remaining",
  "description": "Commitment amount fell below 10%",
  "active": true,
  "eventName": "configuration.commitment.updated",
  "calculation": "(new.amountSpent >= ((new.amount*90)/100)) \nAND ((old.amountSpent <= ((old.amount*90)/100)) OR (old.amountSpent == null))",
  "code": "commitment_under_10_percent"
}