Assign, change, or remove a phone number for a user

When you set up Calling Plans or Operator Connect, you assign phone numbers to your users. In Microsoft Teams, the phone number that you assign is listed when a user clicks Calls.

This article applies to Calling Plans and Operator Connect. For information about assigning, changing, or removing a phone number from a user in a Direct Routing scenario, see Enable users for Direct Routing, voice, and voicemail.

Before you assign a number for a Calling Plan or Operator Connect user, you must get numbers for your users. For more information, see Get numbers for Calling Plan users or Set up numbers for Operator Connect users.

Note

One way to see whether a user has a license assigned is by going to the Microsoft Teams admin center > Users. If a license is assigned, it will be indicated on the page. You can also use the Microsoft 365 admin center.

Assign a phone number to a user

To assign a number by using the Teams admin center:

  1. In the left navigation, click Voice > Phone numbers.

  2. On the Phone numbers page, select an unassigned number in the list, and then click Edit.

  3. In the Edit pane, under Assigned to, search for the user by display name or user name, and then click Assign.

  4. To assign or change the associated emergency location, under Emergency location, search for and then select the location.

    Note

    If you are assigning numbers to Operator Connect users, you may or may not be able to assign or change the associated emergency location. This functionality will depend on your Operator. Contact your Operator for more information.

  5. Depending on whether you want to send an email to the user with their phone number information, turn off or turn on Email user with telephone number information. By default, this is on.

  6. Click Save.

To assign numbers by using PowerShell, use the Set-CsOnlineVoiceUser cmdlet as follows:

``PowerShell Set-CsOnlineVoiceUser -Identity  -TelephoneNumber


For example:

```PowerShell
Set-CsOnlineVoiceUser -Identity john@contoso.com -TelephoneNumber +14255550101

Note

Because of the latency between Microsoft 365 and Teams, it can take up to 24 hours for users to be enabled. If the phone number isn't assigned correctly after 24 hours, see Phone Number Service Center.

Change a phone number for a user

To change a phone number for a user by using the Teams admin center:

  1. In the left navigation, click Users, locate and double-click the user you want, click Account, and then under General information, make a note of the phone number that's assigned to the user.

  2. In the left navigation, click Voice > Phone numbers.

  3. On the Phone numbers page, select the number that you identified in step 1, and then click Edit.

  4. In the Edit pane, under Assigned to, click the X to remove the user.

  5. Click Save.

  6. On the Phone numbers page, select an unassigned number in the list, and then click Edit.

  7. In the Edit pane, under Assigned to, search for the user by display name or user name, and then click Assign.

  8. To assign or change the associated emergency location, under Emergency location, search for and then select the location.

    Note

    If you are changing numbers for Operator Connect users, you may or may not be able to assign or change the associated emergency location. This functionality will depend on your Operator. Contact your Operator for more information.

  9. Click Save.

For a PowerShell example, see Set-CsOnlineVoiceUser.

Remove a phone number from a user

To remove a phone number by using the Teams admin center:

  1. In the left navigation, click Users, locate and double-click the user you want, click Account, and then under General information, make a note of the phone number that's assigned to the user.

  2. In the left navigation, click Voice > Phone numbers.

  3. On the Phone numbers page, select the number that you identified in step 2, and then click Edit.

  4. In the Edit pane, under Assigned to, click the X to remove the user.

  5. Click Save.

For a PowerShell example, see Set-CsOnlineVoiceUser.

What is address validation?

Manage phone numbers for your organization

Emergency calling terms and conditions

Emergency Calling disclaimer label

Set-CsOnlineVoiceUser