---
title: "Upsert a business's notification settings (agents:write) — toggle alerts and set notification email/phone. Closes the gap that previously required service-role notification_settings writes."
method: PATCH
path: "/v1/notification-settings"
---

# Upsert a business's notification settings (agents:write) — toggle alerts and set notification email/phone. Closes the gap that previously required service-role notification_settings writes.

`PATCH /v1/notification-settings`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/notification-settings`
- Auth: HTTP bearer

## Request body

- object
  - `business_id` string, required
  - `new_lead_notification_enabled` boolean
  - `lead_update_notification_enabled` boolean
  - `email_notifications` boolean
  - `in_app_notifications` boolean
  - `sms_notifications` boolean
  - `usage_alert_75_enabled` boolean
  - `usage_alert_90_enabled` boolean
  - `usage_alert_100_enabled` boolean
  - `payment_failure_alert_enabled` boolean
  - `notification_email` string
  - `notification_phone` string
  - `escalation_rules` object[]: Post-call escalation rules: [{ id?, when, then?, enabled? }]. Alerts go to notification_phone/notification_email. null clears all rules.

## Response `200`

Updated notification settings

---

[API](https://skmtc.dev/kaicalls/apis/kaicalls-public-api.md) · [All operations](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/revisions/e607fc6cf36e?raw)