Set Emergency (911) Address
request_emergency_addressSets the E911 service address for a business phone line so 911 calls reach the correct dispatcher. The owner must acknowledge the 911 notice and approve before it replaces the address on file.
Instructions
Set the emergency (E911) service address for one of the business's phone numbers with the phone carrier, so a 911 call from that line reaches the right dispatcher. Needs phone_number, the full street address and disclosure_acknowledged true after the owner reads the 911 notice, plus the owner's confirmed approval. Replaces any address on file for that number. Returns needs_user_input, needs_approval, pending_approval, executed, denied or unsupported; only executed means the change was made.
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>",
"address": "<address>",
"disclosure_acknowledged": "<disclosure_acknowledged>",
"idempotency_key": "<idempotency_key>"
},
"name": "request_emergency_address"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actor | No | Do not set. Kept for older clients; the signed-in connection identifies you. | |
| reason | No | Why the change is being made; kept in the audit log. | |
| address | Yes | Where the phone is used. | |
| dry_run | No | Check access, inputs and approval without making the change. | |
| authority | No | Do not set. It cannot approve a change: the owner approves through review_url or by being signed in. | |
| source_ref | No | Optional reference for the request, such as a ticket or automation run ID. | |
| business_id | No | Business ID. Required when the token can reach more than one business. | |
| phone_number | Yes | The business line, in E.164 format. | |
| idempotency_key | Yes | Required to make the change. Repeating a key returns the first outcome instead of running the change again. | |
| queue_for_approval | No | When approval is missing, create a pending approval the owner can accept in the dashboard instead of returning needs_approval. | |
| disclosure_acknowledged | Yes | True only after the owner has read and accepted the 911 service notice. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | ||
| error | No | Present when success is false | |
| intent | No | ||
| result | No | ||
| status | No | ||
| message | No | ||
| success | Yes | Whether the tool completed successfully | |
| summary | No | ||
| approval | No | ||
| request_id | No | ||
| risk_level | No | ||
| business_id | No | ||
| missing_fields | No |