Event Trigger

The Event Trigger fires a workflow whenever an event matching the criteria defined in the trigger's configuration is created or changes state.

Node Properties

There are three configurable criteria for matching events...

Event Criteria

• Event Level: The "level" of the event, with levels of Any, Info, Warning, Error, and Critical. The Any option will fire the trigger for an event of any level.
• Event Subject: The "subject" of the event. Event subjects use case insensitive matching, with support for globbing. Leaving this field blank will cause the trigger to fire for any subject.
• State: The "state" of the event, with the options of New (or reopened), Acknowledged, and Resolved.

In the above example, the workflow will be triggered whenever an event is created or placed in the "new" state with an Event Level of "Error" and has the subject "Abnormal Power Draw".

Note: Any filters applied to the trigger are evaluated after event updates - meaning, for example, that a "Level" filter of "Error" will fire the trigger when an event is created at the "Error" level or an event is modified to changing its level to "Error". The trigger will not fire when an event is changed from the "Error" level to another level.

Payload

The payload will include information about the event on the data field, as well as the standard workflow payload information. In the general case, an Event Trigger workflow payload will look like the following:

▶
(root){} 12 keys
applicationId:"555555555555eeeeeeeeeeee"
applicationName:"My Great Application"
▶
data:{} 14 keys
▶
allUpdates:[] 1 item
creationDate:Wed Dec 03 2025 19:11:30 GMT+0000 (Coordinated Universal Time) (Date object)
▶
data:{} 1 key
deviceId:"222222222222bbbbbbbbbbbb"
deviceName:"<name of associated device>"
▶
eventTags:{} 1 key
id:"222222222222bbbbbbbbbbbb"
▶
latestUpdate:{} 12 keys
level:"<critical|error|warning|info>"
message:"<message included in the event creation>"
sourceId:"<ID of the source that created/updated the event>"
sourceType:"<apiToken|flow|user>"
state:"<new|acknowledged|resolved>"
subject:"<subject of the event>"
flowId:"333333333333cccccccccccc"
flowName:"My Great Workflow"
flowVersion:"myFlowVersion"
▶
globals:{} 3 keys
relayId:"<ID of the resource that created/updated the event>"
relayType:"<apiToken|flow|user|experienceUser|public>"
time:Wed Dec 03 2025 19:11:30 GMT+0000 (Coordinated Universal Time) (Date object)
triggerId:"<any|error|critical|warning|info>"
triggerType:"event"

• data.deviceId: The ID of the device that is associated with this event. This field will be undefined if a device is not associated with this event.
• data.deviceName: The name of the associated device. If not present but data.deviceId is present, this indicates that the device has since been deleted.
• data.updates: An array of update objects applied to the event over time. Each object may have the following properties ...
  • comment: A comment included as part of the update, if applicable.
  • creationDate: A Date object indicating when the update was made.
  • data: Structured data included as part of the update, if applicable.
  • deviceIdChange: If present, indicates the ID of the associated device changed as part of the update. The value is an object with the following keys ...
    • new: The ID of the device after the update. If not present, this indicates the device association was removed as part of the update.
    • newDeviceName: The name of the newly associated device. If not present but new is present, this indicates that the device has since been deleted.
    • old: The ID of the device before the update. If not present, this indicates the device association was added as part of the update.
    • oldDeviceName: The name of the previously associated device. If not present but old is present, this indicates that the device has since been deleted.
  • levelChange: An object with new and old properties indicating that a change in the event level occurred as part of the update.
  • sourceId: The ID of the entity that applied the update.
  • sourceName: The name, if applicable, of the entity that applied the update.
  • sourceType: The type of entity that applied the update.
  • state: The event state after the update is applied.
  • stateChange: An object with new and old properties indicating that a change in the event state occurred as part of the update.
  • subjectChange: An object with new and old properties indicating that a change in the event subject occurred as part of the update.
  • tagsChange: An object whose keys are the keys of tags that were updated in the operation and whose values are an object with the following keys ...
    • new: The value of the tag key after the update. If not present, this indicates the tag was deleted.
    • old: The value of the tag key before the update. If not present, this indicates the tag was added.
• triggerId will be the level the Event Trigger is set to trigger on. For example, if the Event Level is set to Any Level, this field will be "any".
• data.sourceId: The ID of the entity that originally created the event.
• data.sourceName: The name of the entity that originally created the event.
• data.sourceType: The type of entity that originally created the event.
• data.data: Any additional data that you included with the event. If no additional data is included, this field will be undefined.
• data.latestUpdate: The most recent update, which matches the last item in the data.updates array. This will be undefined for new events.
• relayId: Matches data.latestUpdate.sourceId - or if the event has no updates, this matches data.sourceId.
• relayType: Matches data.latestUpdate.sourceType - or if the event has no updates, this matches data.sourceType.

Note: A sourceType or relayType of "public" anywhere in the trigger payload of public means that an event was created or updated by an unauthenticated Experience User or through a Public Dashboard.

Related Nodes

• Event: Create Node
• Event: Delete Node
• Event: Get Node
• Event: Update Node