Create address endpoint

POST

/domains/{domain}/addresses/endpoints

Last modified:2026-10-09 00:39:09

OperationId:CreateAddressEndpoint

Registers a callback number with the emergency calling carrier against an address, and stores it as an endpoint of the domain.

Requires Reseller scope for the domains in your territory, or Super User scope. Other scopes get 403.

An endpoint is a callback number registered with the emergency calling carrier against an address. It is the number the 911 operator sees and calls back. A user uses it by setting caller-id-number-emergency to the number. Endpoints are stored with the addresses: emergency-address-id is the callback number and user is always address_endpoint.

address-callback-number, caller-name, and carrier are required. carrier is bandwidth, brightlink, inteliquent, or voipinno. What else is needed depends on carrier:

bandwidth: an address the carrier already has, in emergency-address-id, or address-formatted-pidflo from validate. The stored address is the one the carrier returns

brightlink: a Brightlink location ID in emergency-address-id. Add address-formatted-pidflo to create that location first

inteliquent: address-formatted-pidflo, or address-line-1, address-city, address-state-province-abbreviation, and address-postal-code

voipinno: address-line-1, address-line-2, address-city, address-state-province-abbreviation, and address-postal-code

The carrier is called before the response, so it can take several seconds. A carrier error returns 400 with the carrier's reason. A 202 means the change is accepted and applied shortly after.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

The change is accepted and applied shortly after this response.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Request Example

Shell

JavaScript

Java

Swift

cURL

Bandwidth, existing addressBandwidth, new address from validateInteliquent, address fields

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/domains//addresses/endpoints' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "address-callback-number": "5555550100",
    "caller-name": "Front Desk",
    "address-name": "Main Office",
    "carrier": "bandwidth",
    "emergency-address-id": "a-6525c1ae9d7ff"
}'

Response Example

202 - Accepted

{
    "code": 202,
    "message": "Accepted"
}

Modified at 2026-10-09 00:39:09

Delete user address

List address endpoints