Get Teams Phone Number Assignment

Looks up, if the given phone number is assigned to a user in Microsoft Teams.

Description

This runbook looks up, if the given phone number is assigned to a user in Microsoft Teams. If the phone number is assigned to a user, information about the user will be returned.

Additional documentation

If a Teams user is found for the phone number, the following details are displayed:

• Display name

• User principal name

• Account type

• Phone number type

• Online voice routing policy

• Calling policy

• Dial plan

• Tenant dial plan

Location

Organization → Phone → Get Teams Phone Number Assignment

Permissions

Application permissions

• Type: Microsoft Graph

  • Organization.Read.All

RBAC roles

• Teams Administrator

Parameters

PhoneNumber

The phone number must be in E.164 format. Example: [phone] or [phone];ext=123. It must start with a '+' followed by the country code and subscriber number, with an optional ';ext=' followed by the extension number, without spaces or special characters.

Property	Value
Required	true
Default Value
Type	String

Back to Runbook Reference overview