UDP Message Trigger

The UDP Message Trigger will trigger a workflow whenever the Edge Compute device receives a UDP datagram on the configured port.

Node Properties

UDP Port

The UDP Message Trigger has one piece of configuration, the port to listen on. When a workflow with this trigger is deployed to an Edge Compute device, the Gateway Edge Agent will open a UDP server on this port. When that UDP server receives a datagram, the workflow will trigger.

Payload

The payload will include the triggering datagram under data object, which will include the following fields:

• message: The contents of the incoming datagram.
• sourceAddress: The source address of the incoming datagram.
• sourcePort: The source port of the incoming datagram.

Given a UDP datagram received on port 45678 with the contents Hello, World!, a UDP Message Trigger workflow payload will look like the following:

▶
(root){} 17 keys
▶
agentEnvironment:{} 1 key
agentVersion:"1.31.0"
applicationId:"555555555555eeeeeeeeeeee"
applicationName:"My Great Application"
▶
data:{} 3 keys
message:"Hello, World!"
sourceAddress:"192.168.1.204"
sourcePort:"12345"
▶
device:{} 8 keys
deviceId:"222222222222bbbbbbbbbbbb"
deviceName:"My Great Device"
▶
deviceTags:{} 2 keys
flowId:"333333333333cccccccccccc"
flowName:"My Great Workflow"
flowVersion:"myFlowVersion"
▶
globals:{} 3 keys
isConnectedToLosant:true
time:Tue Aug 19 2025 15:16:18 GMT+0000 (Coordinated Universal Time) (Date object)
triggerId:"45678"
triggerType:"udp"