Setting up virtual tenants for numbers

  • Last update on September 15th, 2023

If you wish to delegate responsibility for managing numbers to delegated administrators, you can create or edit your virtual tenants to include number information.

Please keep in mind that all phone number types can be delegated to virtual tenants, ensuring a comprehensive approach to number management.


Your V-tenants for users match your number distribution

If your virtual tenants for users match your number distribution, you can simply edit your existing virtual tenants. For example, you may break down your virtual tenants by country and want your numbers distributed by country, OR your virtual tenants are organized by department and your numbers will also be distributed to departments. However, if they don’t match, you can set up virtual tenants specifically for numbers. For example, you might want your phone numbers distributed by country, although your virtual tenants are broken down by Business Unit.  

You can populate your virtual tenants based on which users are already assigned direct routing numbers. When you upload the list of direct routing numbers, you can identify the user assigned to each number. If there is a conflict between the data provided by the SBC and the data contained within Teams you can see that on the Teams Numbers report. Use the “Mismatch between Teams and SBC assignee” field to find and resolve data conflicts.

You can have a quick snapshot of your virtual tenant users who have a phone number assigned to them in a dedicated section. Please keep in mind that a user can be a part of multiple virtual tenants, in that the user and the number assigned to them will be visible in more than one virtual tenant. On the other hand, you can only distribute spare numbers to one virtual tenant, meaning that, depending on the scenario, the number assigned to a user can be allocated to your virtual tenant or not.

You can then distribute the remaining inventory based on criteria with the ability to “cap” the number given to each virtual tenant. For example, you can allocate a virtual tenant 50 numbers from the remaining UK phone number inventory.  

Your V-tenants for numbers don't match your V-tenants for users

If your virtual tenants for numbers are not the same as your virtual tenants for users, an operator could have responsibility for managing a number but not the user who has the number. In this case, the operator would be able to do the following:    

  • Assign a number only to users matching delegation filters in the virtual tenant to which the operator delegated to managing the number is assigned. 
  • Unassign a number only to users matching delegation filters in the virtual tenant to which the operator delegated to managing number is assigned.
  • View the User ID and UPN of the user assigned a number only to users matching the delegation filters set for users in the virtual tenant to which the operator delegated to managing number is assigned. This means that if a number that has been allocated to a virtual tenant is assigned, via means different than CoreView, to a user that is outside of the scope of that virtual tenant, the possibility to manage that number is lost until the number is unassigned from the “wrong” user.


  • Go to “Settings” > “Virtual Tenants”
  • Create a new virtual tenant or access an already existing one 
  • Go to the “Phone number” tab 
  • Optional: have a quick check of your configuration in the “Overview” tab, where you can see your number allocation rules and the amount of allocated and consumed numbers in your virtual tenant.
  • Optional: have a look at the “Consumed” tab to see which users assigned to your virtual tenant have a phone number assigned to them.
  • Go to the “Spare numbers” tab. Here, you can decide the criteria by which you want to allocate spare numbers (numbers that are not assigned to anyone or not part of any other virtual tenant) to your virtual tenant. You can decide to segregate based on a variety of attributes and, based on the amount of numbers that fit your criteria, decide to allocate all of the results or only a part of them. The filtering is dependent on the number plan type, so you can have different criteria for Teams numbers and direct routing numbers.
  • Save and complete the configuration.