alert.triggered
When Signals sends alert.triggered, its payload and how to handle it in Node.js, Python and Java.
A reading breaches a trigger and opens an alert.
Payload
Every delivery is the envelope type, timestamp, sequence and data; the delivery's id is the webhook-id header. See Verify webhooks.
{
"type": "alert.triggered",
"timestamp": "2026-10-25T08:00:02.000Z",
"sequence": 1042,
"data": {
"id": "0b9d7e52-1f3a-4e8c-b6a2-7c4d9e1f2a35",
"patient": "6f1c2a8e-3b7d-4c55-9a0e-2d4b8f6e1a90",
"observation": "a3e8f1c2-5d6b-4a7e-9c0f-1b2d3e4f5a6b",
"observationObservedAt": "2026-10-25T08:00:00.000Z",
"component": {
"code": {
"coding": [
{
"code": "8867-4",
"system": "http://loinc.org"
}
]
},
"valueQuantity": {
"value": 132,
"unit": "/min"
}
},
"triggerCode": "8867-4",
"triggerVersion": 1,
"value": 132,
"message": "Heart rate above 110 /min",
"reason": "trigger",
"createdAt": "2026-10-25T08:00:02.000Z",
"updatedAt": "2026-10-25T08:00:02.000Z",
"effectiveTS": "2026-10-25T08:00:00.000Z",
"observationRefId": "reading-0001",
"derivedObservation": null,
"patientRefId": "resident-001",
"episodeId": "e7a1b2c3-d4e5-4f60-8a9b-0c1d2e3f4a5b",
"acknowledgedAt": null,
"acknowledgedBy": null,
"version": 1
}
}| Field | Meaning |
|---|---|
id | The alert. The same alert keeps its id through alert.refired, alert.resolved and alert.acknowledged. |
patient, patientRefId | The patient, by Signals id and by your own refId. |
observation, observationRefId | The reading that raised it, by Signals id and by its first identifier. |
triggerCode, value, message | The code that breached, its value, and Signals' message. |
episodeId | The episode the alert belongs to, or null with episodes off. |
acknowledgedAt, acknowledgedBy | When and by whom it was acknowledged, or null. |
version | Rises with each change. Ignore a delivery whose version is lower than one you already handled. |
Handle the event
Verify the delivery first (Verify webhooks), then act on the verified event as in Handle an event.
export async function handle(webhookId, event) {
if (!(await firstTime(webhookId))) return;
const { data } = event;
switch (event.type) {
case 'alert.triggered':
await saveAlert(data);
await notifyCareTeam(data.patientRefId, data.message);
break;
default:
break;
}
}Related
Last updated on