alert.acknowledged
When Signals sends alert.acknowledged, its payload and how to handle it in Node.js, Python and Java.
Someone acknowledges the alert for the first time. Acknowledging it again sends nothing.
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.acknowledged",
"timestamp": "2026-10-25T08:00:02.000Z",
"sequence": 1045,
"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:05:00.000Z",
"effectiveTS": "2026-10-25T08:00:00.000Z",
"observationRefId": "reading-0001",
"derivedObservation": null,
"patientRefId": "resident-001",
"episodeId": "e7a1b2c3-d4e5-4f60-8a9b-0c1d2e3f4a5b",
"acknowledgedAt": "2026-10-25T08:05:00.000Z",
"acknowledgedBy": {
"reference": "Practitioner/123",
"display": "Dr. Max Mustermann"
},
"version": 3
}
}The data fields are those of alert.triggered. acknowledgedBy is the actor the acknowledging call named, or null when it named none.
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.acknowledged':
await markAcknowledged(data.id, data.acknowledgedBy, data.version);
break;
default:
break;
}
}Related
Last updated on