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: +49321987654 or +49321987654;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

Last updated

Was this helpful?