Set Emergency (911) Address
request_emergency_addressSet 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 |