Set A Client's Lead Alerts
agency_clients_set_client_alertsConfigure a client’s lead alerts: choose all or qualified leads, set alert emails and phones, and control KaiCalls product updates. This updates settings only and sends no messages.
Instructions
Changes one client's lead alerts: every lead or qualified leads only, whether the client gets KaiCalls product updates, and which emails and phones get the alerts. Requires write access to that client (agency owner/admin, or an operator assigned to it, who is also an admin on the client's account). Recorded in the client's change history. Sends nothing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"partnerId": "<partnerId>",
"businessId": "<businessId>"
},
"name": "agency_clients_set_client_alerts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| partnerId | Yes | The agency (partner) workspace ID. | |
| businessId | Yes | The client business to change. | |
| leadAlerts | No | 'qualified' (only leads scored 70 or more), 'all' (every real lead) or 'default'. | |
| alertEmails | No | Comma-separated emails that get lead alerts; empty or null clears them. | |
| alertPhones | No | Comma-separated phones that get lead alert texts; empty or null clears them. | |
| kaicallsUpdatesEnabled | No | Whether the client gets KaiCalls product and account updates; null for the default. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when success is false | |
| receipt | No | ||
| success | Yes | Whether the tool completed successfully |