Create user address

Creates a personal emergency (E911) address for the user in the path. Only that user sees it in GET /domains/{domain}/users/{user}/addresses, next to the shared site and domain-level addresses.

Basic User scope can call it for its own user, with ~ or its own extension. Office Manager and Site Manager scopes can call it for any user in their domain, Reseller scope for the domains in its territory, and Super User scope for any domain.

address-name and address-line-1 are required. emergency-address-id is optional: without it the API generates one, a- followed by 13 hexadecimal characters. An ID already used in any domain returns 409. To add an address the carrier has checked, call POST /domains/{domain}/addresses/validate first, then send its emergency-address-id, address-formatted-pidflo, and carrier with the other fields. address-formatted-pidflo is used only together with a supported carrier: bandwidth, brightlink, inteliquent, or voipinno. Without one, the address is saved with an empty address-formatted-pidflo.

Returns 200 with the address as stored. The address is stored shortly after the response, so a read straight after may not show it yet. Creating the address does not assign it: set the user's emergency-address-id to use it.

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//users//addresses' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "address-name": "Home office", "caller-name": "Remote Worker", "address-line-1": "127 Example St", "address-line-2": "Apt 2", "address-city": "Example City", "address-state-province-abbreviation": "CA", "address-postal-code": "90210", "address-country-abbreviation": "US", "address-location-description": "" }'

{ "domain": "example.com", "user": "1001", "emergency-address-id": "a-6525c1ae9d802", "address-name": "Home office", "caller-name": "Remote Worker", "address-line-1": "127 Example St", "address-line-2": "Apt 2", "address-city": "Example City", "address-state-province-abbreviation": "CA", "address-postal-code": "90210", "address-country-abbreviation": "US", "address-location-description": "" }

Request

Responses