Table of Contents

TeamsTelephoneNumber.ReadWrite.All

Allows the app to read and modify your tenant's acquired telephone number details on behalf of the signed-in admin user. Acquired telephone numbers may include attributes related to assigned object, emergency location, network site, etc.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the TeamsTelephoneNumber.ReadWrite.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category Application Delegated
Identifier 0a42382f-155c-4eb1-9bdc-21548ccaa387 424b07a8-1209-4d17-9fe4-9018a93a1024
DisplayText Read and Modify Tenant-Acquired Telephone Number Details Read and Modify Tenant-Acquired Telephone Number Details
Description Allows the app to read your tenant's acquired telephone number details, without a signed-in user. Acquired telephone numbers may include attributes related to assigned object, emergency location, network site, etc. Allows the app to read and modify your tenant's acquired telephone number details on behalf of the signed-in admin user. Acquired telephone numbers may include attributes related to assigned object, emergency location, network site, etc.
AdminConsentRequired Yes Yes

Graph Methods

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

Graph reference: numberAssignment

Property Type Description
activationState microsoft.graph.teamsAdministration.activationState The activation state of the telephone number. The possible values are: activated, assignmentPending, assignmentFailed, updatePending, updateFailed, unknownFutureValue.
assignmentCategory microsoft.graph.teamsAdministration.assignmentCategory Contains the assignment category such as Primary or Private. The possible values are: primary, private, alternate, unknownFutureValue.
assignmentStatus microsoft.graph.teamsAdministration.assignmentStatus The assignment status of the phone number. The possible values are: unassigned, internalError, userAssigned, conferenceAssigned, voiceApplicationAssigned, thirdPartyAppAssigned, policyAssigned, unknownFutureValue.
assignmentTargetId String The ID of the object the phone number is assigned to, either the ObjectId of a user or resource account, or the policy instance ID of a Teams shared calling routing policy instance.
capabilities microsoft.graph.teamsAdministration.numberCapability collection The list of capabilities assigned to the phone number.
city String The city where the phone number is located or associated with.
civicAddressId String The ID of the civic address assigned to the phone number.
id String The ID of the operation. Inherited from microsoft.graph.entity. Inherits from entity.
isoCountryCode String The ISO country code assigned to the phone number.
locationId String The ID of the location assigned to the phone number.
networkSiteId String This property is reserved for internal Microsoft use.
numberSource microsoft.graph.teamsAdministration.numberSource The source of the phone number. online is used for phone numbers assigned in Microsoft 365, and onPremises is used for phone numbers assigned in AD on-premises, which are synchronized into Microsoft 365. The possible values are: online, onPremises, unknownFutureValue.
numberType microsoft.graph.teamsAdministration.numberType The type of the phone number. The possible values are: internalError, directRouting, callingPlan, operatorConnect, unknownFutureValue.
operatorId String The ID of the operator.
portInStatus microsoft.graph.teamsAdministration.portInStatus The status of any port in order covering the phone number. The possible values are: completed, firmOrderCommitmentAccepted, unknownFutureValue.
reverseNumberLookupOptions microsoft.graph.teamsAdministration.reverseNumberLookupOption collection Status of Reverse Number Lookup (RNL). If set to skipInternalVoip, calls are routed through the external Public Switched Telephone Network (PSTN) instead of using internal VoIP resolution.
supportedCustomerActions microsoft.graph.teamsAdministration.customerAction collection Indicates what customer actions are available to modify the number.
telephoneNumber String The telephone number in the record. The recorded telephone number is always displayed with a '+' prefix, regardless of whether it was originally assigned with one.