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.

alert-acknowledged.js
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;
  }
}

Last updated on

On this page