Add Team Phone
add_team_phoneAdd a teammate's (or the owner's) cell to the phones that ring before Kai answers. Idempotent — a cell already listed is reported as already included. Owners and admins are also registered on the admin roster, so calling the business line from that cell reaches the admin secretary; a member only rings. The business's own forwarded-from office line is refused (forwarding_loop) because ringing it would bounce the call straight back. Requires the phone system to be set up first (set_up_phone_system).
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": {
"phone_number": "<phone_number>"
},
"name": "add_team_phone"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name for this teammate (optional). | |
| role | No | member only rings; owner and admin also get admin-secretary access from this cell. Defaults to admin. | |
| business_id | No | Business ID (required when the token can access multiple businesses). | |
| phone_number | Yes | The cell to add, US format (e.g. (908) 555-1234 or +19085551234). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Present when success is false. | |
| error | No | Present when success is false | |
| member | No | ||
| success | Yes | Whether the tool completed successfully | |
| business_id | No |