Skip to content
FolioSign inStart your trial

Webhook event catalogue

Care events

1 events. All groups

care.alert_created#

A care alert was raised. The message itself is never included; open the alert in Folio.

Metadata only. No conversation or question text, no contact details, no names or email addresses of people, and no crisis content. Ids, kinds, states and times so you can open the record in Folio.

data.object.object is care_alert.

Fields of data.object for care.alert_created
FieldTypeDescription
acknowledged_at requiredstring (date-time) | nullWhen a team member acknowledged it.
assigned_to requiredobject | nullThe team member handling it.
id requiredstringThe team member id.
object requiredenum: userAlways user.
category requiredstringThe kind of concern.
created_at requiredstring (date-time)When it was raised.
detection requiredenum: lexicon | model | uncertain | classifier_unavailableHow it was found.
id requiredstringThe care alert id.
object requiredenum: care_alertAlways care_alert.
status requiredenum: open | acknowledged | handledWhere handling stands.
surface requiredenum: widget | staff | api | member_app | whatsappWhere it was raised.
urgency requiredenum: low | elevated | medium | high | criticalHow soon it needs attention.
Example care.alert_created body
{
  "actor": null,
  "api_version": "2026-12-01",
  "created": "2026-10-13T09:12:10Z",
  "data": {
    "object": {
      "acknowledged_at": "2026-10-13T09:12:10Z",
      "assigned_to": {
        "id": "usr_0192f7a8-3b1c-7d2e-9a40-5c6d7e8f9012",
        "object": "user"
      },
      "category": "suicide_self_harm",
      "created_at": "2026-10-13T09:12:10Z",
      "detection": "lexicon",
      "id": "car_0192f7a8-3b1c-7d2e-9a40-5c6d7e8f9012",
      "object": "care_alert",
      "status": "open",
      "surface": "widget",
      "urgency": "high"
    }
  },
  "id": "evt_0192f7a8-3b1c-7d2e-9a40-5c6d7e8f9012",
  "livemode": false,
  "object": "event",
  "request": {
    "id": "req_5f3c9a1e7b2d4c68a0e1f2d3c4b5a697",
    "idempotency_key": null
  },
  "type": "care.alert_created"
}

Verified against API version 0.0.0-dev. Generated from the live OpenAPI document.