Create an alert rule | CAIL Health

Creates a new alert rule for the operator’s organisation. Use the catalog endpoint to discover supported event types and recommended defaults. When condition is omitted, the catalog default for the event type is applied.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

namestringRequired

Human-readable name for the rule.

eventTypestringRequired

Event type code the rule listens for. Use the alert-rule catalog endpoint to discover available codes.

conditionobjectOptional

Threshold condition that must evaluate true to fire the alert. Omit to use the event-type’s catalog default.

channelenumOptional

Delivery channel. Defaults to both.

Response

The newly-created alert rule.

dataobject

messagestring

Human-readable acknowledgement.

$	curl -X POST https://staging.cail.health/v1/alert-rules \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"name": "A&E diversion alert",
>	"eventType": "a_and_e_diversion_rate"
>	}'

1	{
2	"data": {
3	"id": "1d7d4e29-3b8e-4a01-a4f1-7e2a5b8c1d6e",
4	"organizationId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
5	"name": "A&E diversion alert",
6	"eventType": "a_and_e_diversion_rate",
7	"channel": "both",
8	"isActive": true,
9	"createdAt": "2026-05-13T14:21:00.000Z",
10	"lastUpdated": "2026-05-13T14:21:00.000Z",
11	"condition": {
12	"field": "avoidanceRate",
13	"operator": "<",
14	"value": 0.6
15	}
16	},
17	"message": "Alert rule created"
18	}