Table of Contents

Serviceable Addresses: Overview and Usage

Mitchell Paul-Soumis Updated by Mitchell Paul-Soumis

Read Time: 7 mins

Serviceable Addresses in Sonar allow you to add and track addresses or locations to which you can deliver some service, regardless of the delivery method. Additionally, when a Serviceable Address is added to your Sonar instance, and information or inventory is assigned to it, this information is stored and tracked in perpetuity. The Serviceable Address function allows a new customer to be set up quickly and easily at pre-qualified locations or previously occupied physical locations.

This functionality provides more control over previous account management methods in two main ways:

  1. Serviceable Addresses maintain the IP Assignments, Inventory history, elevation, and any other device or location-specific traits. This simplifies the process of changing customers when one moves out and another moves in.
  2. This approach is superior to renaming old accounts to preserve this information, as it protects against the risk of new users accessing old transaction history for their location.

Adding a New Serviceable Address

New Serviceable Addresses in Sonar can be added in one of two ways:

  1. During the creation process for a new customer account
  2. From the Settings > Accounts > Serviceable Addresses page

Creating a Serviceable Address from either location opens up the "Create Serviceable Address" modal, which allows you to add a new address, or location, to your instance:

While there is a validation check that takes place to ensure your serviceable address is not a duplicate, it will accept any address regardless of context. Check your validations closely when submitting a new serviceable address.

Adding a Serviceable Address Using GPS Coordinates Only

It is possible to add a new serviceable address using GPS coordinates; this is particularly beneficial when developing a lead intake form. To do this you would need to follow the steps below:

  1. Get the customer's address, then perform an API call to somewhere (e.g., Google Maps) to get the GPS coordinates. As an easier alternative to this step, put in static GPS coordinates to be converted later.
    Note that they must be real GPS coordinates (i.e., don't use 0,0 which puts you in the ocean off the coast of Ghana). Using your headquarters is recommended, as you can filter on that later to find addresses with incomplete coordinates.
  2. Create the serviceable address in Sonar (using the createServiceableAddress mutation) and read the ID that it outputs.
  3. Feed that ID into the createAccount mutation (outlined in this article here) using the serviceable_address_id property.

Serviceability Statuses

Serviceability Statuses provide the ability to categorize addresses as needed. For example, during a Fiber deployment there may be certain addresses that will not be receiving drops until a specific date, or at all, and having that status easily viewable makes it easy for your sales team to know what they can or cannot offer.

To make adjustments to statuses in your instance, navigate to Settings > Accounts > Serviceability Statuses.

A default status is automatically added to your instance, and all accounts are enrolled with that status. While you can edit this status by renaming it, changing its icon, or altering the color, you cannot delete it. New statuses can be added by clicking on the blue Create Serviceability Status button in the upper right corner. To make adjustments to serviceability statuses, click Edit alongside the corresponding line item and use the following modal to make your changes:

How to Edit an Addresses Serviceability Status

The Serviceability Status dropdown is available via the Edit Serviceable Address modal, which can be accessed from a few different spots within your instance.

  1. Navigate to Settings > Accounts > Serviceable Addresses and locate the address you wish to adjust, then click on Edit. With the new modal populated, use the first dropdown to make your selection and then save your changes.
  2. Navigate to the addresses management page and click Edit. This will populate the same modal as the above screenshot.
  3. Navigate to a customer's account and click Edit alongside their serviceable address. Once again, the same modal will populate.

Network Site Connections

Network Site Connections offer a way to link a serviceable address to a network site, even before any networking equipment is deployed to the address. This feature can be particularly beneficial during a Fiber deployment to distinguish which locations will route through which network sites. The table within Service Addresses reflects any associated network sites via the Network Sites column.

You can add network site connections to a serviceable address during the creation process or at a later time via the edit modal. The same edit modal allows you to change or delete a network site connection at any time.

Using Serviceable Addresses

Serviceable Addresses are a critical function in Sonar, as inventory assigned to a customer's home for provisioning is stored and tracked with the serviceable address. Fundamentally, this means that each Serviceable Address is unique, and must always remain unique, even while the accounts which use this address aren't necessarily unique. In this section, we'll be taking a look at a few example scenarios of how to use accounts and serviceable addresses together.

Example 1: A resident moves out

In this example, a current customer of a WISP will be moving out of their home. This customer has had an access point installed at the address to receive service, and trees removed. As a result, the WISP knows that this address remains a location to which services can be offered. Ordinarily, the account would simply be made inactive, and when a new customer signs up at the address, inventory would need to be migrated. In Sonar, this same scenario is simplified, as when a new customer moves in, the equipment and IP assignment history is tied to the address, and will all be migrated automatically.

To make a previously occupied serviceable address available once again, you would disconnect the account. For more information on how to disconnect an account, refer to the Disconnecting an Account article.

Example 2: In a shared home, the service contract is being picked up by another

In this example, a home is being shared by several roommates, and the contract for their data service will be getting picked up by a new resident once the current contract expires. In many cases, you would need to change the name of the account, the primary account owner, the contact information, and possibly even custom fields on the account. However, this may result in the new account owner inadvertently being granted access to billing information that belonged to the previous contract owner. By leveraging serviceable addresses, you retain the IP information and device assignments while creating an entirely new account without any legacy billing information or network access credentials.

Example 3: Multiple Accounts sharing a serviceable address

In Sonar, we allow you to import past customer information into your instance, and in some cases this may result in two accounts that would share a serviceable address. Unfortunately, the versatility and robustness of the Serviceable Address function means that you can't have two accounts with the same serviceable address, however, there are some alternatives:

  1. If this address is split up into different units or residences, or if each service is tied to a separate individual, then the best course of action is to create a unique address for both, with some value added to the "Line 2" field to differentiate them.
  2. If this address should in fact share services, such as a primary service and a backup service, then both services would be on the same account, either as one larger service that triggers pair bonding on the provisioning side, or as a primary data service with a backup recurring service
A Sonar account can't have more than 1 measured Data Service on the account.


In order to make use of some of the features touched on above, the following role permissions must be looked at. Please take a moment to review these permissions and ensure that the relevant roles have them added.

If you're a Super-Admin of your Sonar instance, no permission changes are required for your account. For more information on Roles and Permissions overall, please review this linked article.

Navigate to Settings > Security > Roles and either choose to edit an existing Role or create a new Role. With the next page populated, locate the permissions reflected in the screenshots below and enable whichever ones are applicable to that Role.

Without view serviceable addresses enabled, none of the features mentioned will be usable as the Serviceable Address page won't be reachable.

To be able to utilize the serviceability status portion of serviceable addresses, you must have read address status enabled first and foremost. Without it, you will be able to see the statuses to update or delete them.

The above permission must be enabled for the Network Site Connections portion of the Serviceable Address modal to be visible, along with the Network Sites column on the Serviceable Address page.

How did we do?

CPUC Fixed Broadband Deployment by Address

FCC Data Exports: General Overview and Usage