{
"webhook_type": "alert.triggered",
"object_type": "triggered_alert",
"organization_id": "00000000-0000-4000-8000-000000000001",
"triggered_alert": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"organization_id": "00000000-0000-4000-8000-000000000001",
"alert_id": "00000000-0000-4000-8000-000000000003",
"subscription_id": "00000000-0000-4000-8000-000000000004",
"external_subscription_id": "00000000-0000-4000-8000-000000000005",
"wallet_id": null,
"external_customer_id": "live_9909",
"feature_code": null,
"alert_name": null,
"alert_code": "live_code_134831",
"alert_type": "current_usage_amount",
"current_value": "7.0",
"previous_value": "0.0",
"crossed_thresholds": [
{
"code": null,
"value": "5.0",
"recurring": false
}
],
"triggered_at": "2026-10-22T07:14:58Z",
"subscription_external_id": "00000000-0000-4000-8000-000000000005",
"customer_external_id": "live_9909"
}
}Alerts
A new alert was triggered
A usage alert on a subscription (or a wallet balance alert) crosses one of its thresholds.
WEBHOOK
alert_triggered
{
"webhook_type": "alert.triggered",
"object_type": "triggered_alert",
"organization_id": "00000000-0000-4000-8000-000000000001",
"triggered_alert": {
"nozle_id": "00000000-0000-4000-8000-000000000002",
"organization_id": "00000000-0000-4000-8000-000000000001",
"alert_id": "00000000-0000-4000-8000-000000000003",
"subscription_id": "00000000-0000-4000-8000-000000000004",
"external_subscription_id": "00000000-0000-4000-8000-000000000005",
"wallet_id": null,
"external_customer_id": "live_9909",
"feature_code": null,
"alert_name": null,
"alert_code": "live_code_134831",
"alert_type": "current_usage_amount",
"current_value": "7.0",
"previous_value": "0.0",
"crossed_thresholds": [
{
"code": null,
"value": "5.0",
"recurring": false
}
],
"triggered_at": "2026-10-22T07:14:58Z",
"subscription_external_id": "00000000-0000-4000-8000-000000000005",
"customer_external_id": "live_9909"
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Signature of the webhook payload
Example:
"Ap¶5ɿΣ6ÐfV£Ä\u0015\u0015ºõÔõÔ[DæAâÿüÚ"
Algorithm used to generate the signature
Available options:
jwt, hmac Example:
"hmac"
Unique id of the webhook. It can be used for idempotency
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Body
application/json
Details of the triggered alert
Available options:
alert.triggered Available options:
triggered_alert Unique identifier of the organization, created by Nozle.
Example:
"1a901a90-1a90-1a90-1a90-1a901a901a90"
Show child attributes
Show child attributes
Response
200
Return a 2xx status within 30 seconds to acknowledge the delivery. Any other status, a timeout or a connection error is a failed attempt; Nozle makes up to 3 attempts.