check before: 2025-10-10
Product:
Microsoft Graph, Teams
Platform:
Developer, Online, World tenant
Status:
Change type:
Admin impact, New feature, Updated message, User impact
Links:
Details:
Summary:
Microsoft Graph now offers Teams administration APIs: Teams User Configuration API (V1.0), Number Management, and Policy Assignment APIs (beta). These enable automation of user settings, phone number management, and policy assignments for Teams admins. APIs support delegated and application permissions in commercial environments.
Details:
Updated January 20, 2026: We have updated the content. Thank you for your patience.
Microsoft Graph now includes APIs that support Teams administration scenarios through beta:
Teams User Configuration API - Available through V1.0
Number Management APIs - Available through beta
Policy Assignment APIs - Available through beta
These APIs enable programmatic access to user configurations, telephone number management, and policy assignments-helping organizations automate and scale Teams management. They are designed to support extensibility, automation, and integrations with your existing tools and workflows.
[When this will happen:]
Please note that only Teams User Configuration API is currently available via the Microsoft Graph through V1.0, rest of the two APIs (Number Management and Policy Assignment) are currently available via the Microsoft Graph through beta. They are supported in commercial environments and accessible through both delegated and application permissions.
Change Category:
XXXXXXX ... free basic plan only
Scope:
XXXXXXX ... free basic plan only
Release Phase:
Created:
2025-10-10
updated:
2026-01-21
Task Type
XXXXXXX ... free basic plan only
Docu to Check
XXXXXXX ... free basic plan only
MS How does it affect me
XXXXXXX ... free basic plan only
MS Preperations
XXXXXXX ... free basic plan only
MS Urgency
XXXXXXX ... free basic plan only
MS workload name
XXXXXXX ... free basic plan only
summary for non-techies**
Microsoft has introduced new beta APIs for Teams administration via Microsoft Graph, enabling IT administrators to efficiently manage Teams settings, phone numbers, and policies with tools like the Teams User Configuration API, Number Management APIs, and Policy Assignment APIs, which support both delegated and application permissions.
Direct effects for Operations**
API Integration Issues
If the new Teams administration APIs are implemented without proper preparation, there may be integration issues with existing systems, leading to disruptions in user management and policy assignments.
- roles: Teams Admin, IT Support
- references: https://learn.microsoft.com/graph/api/teamsadministration-teamsadminroot-list-userconfigurations?view=graph-rest-1.0, https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta
User Experience Disruption
Without adequate preparation, users may experience disruptions in their Teams functionalities, such as inability to access certain features or incorrect policy applications, negatively impacting their productivity.
- roles: End Users, Teams Admin
- references: https://learn.microsoft.com/graph/api/teamsadministration-telephonenumbermanagementroot-list-numberassignments?view=graph-rest-beta, https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta
Configutation Options**
XXXXXXX ... paid membership only
explanation for non-techies**
XXXXXXX ... free basic plan only
** AI generated content. This information must be reviewed before use.
a free basic plan is required to see more details. Sign up here
A cloudsocut.one plan is required to see all the changed details. If you are already a customer, choose login.
If you are new to cloudscout.one please choose a plan.
change history
| Date | Property | old | new |
| 2026-01-21 | MC prepare | Begin exploring the APIs using the Microsoft Graph beta endpoints.
Ensure your applications and scripts use the appropriate permission scopes. For feedback or questions, contact: TeamsAdminGraphApi@microsoft.com Learn more: User Configuration Graph API - List userConfigurations | Microsoft Graph | Microsoft Learn Number Management Graph API(s) - List numberAssignments | Microsoft Graph | Microsoft Learn Policy Assignment/Un-Assignment Graph API(s) - teamsPolicyUserAssignment: assign | Microsoft Graph | Microsoft Learn [Compliance considerations:] No compliance considerations identified, review as appropriate for your organization. https://learn.microsoft.com/graph/api/teamsadministration-teamsadminroot-list-userconfigurations?view=graph-rest-beta&tabs=http https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta https://learn.microsoft.com/graph/api/teamsadministration-telephonenumbermanagementroot-list-numberassignments?view=graph-rest-beta | Begin exploring the APIs using the Microsoft Graph V1.0/beta endpoints.
Ensure your applications and scripts use the appropriate permission scopes. For feedback or questions, contact: TeamsAdminGraphApi@microsoft.com Learn more: User Configuration Graph API - List userConfigurations | Microsoft Graph | Microsoft Learn Number Management Graph API(s) - List numberAssignments | Microsoft Graph | Microsoft Learn Policy Assignment/Un-Assignment Graph API(s) - teamsPolicyUserAssignment: assign | Microsoft Graph | Microsoft Learn [Compliance considerations:] No compliance considerations identified, review as appropriate for your organization. https://learn.microsoft.com/graph/api/teamsadministration-teamsadminroot-list-userconfigurations?view=graph-rest-1.0 https://learn.microsoft.com/graph/api/teamsadministration-teamspolicyuserassignment-assign?view=graph-rest-beta https://learn.microsoft.com/graph/api/teamsadministration-telephonenumbermanagementroot-list-numberassignments?view=graph-rest-beta |
| 2026-01-21 | MC MessageTagNames | New feature, User impact, Admin impact | Updated message, New feature, User impact, Admin impact |
| 2026-01-21 | MC Summary | Microsoft Graph beta now offers Teams administration APIs for user configuration, number management, and policy assignment. These enable automation and integration for Teams management, accessible with delegated or application permissions in commercial environments. Admins can begin exploring these APIs and ensure proper permission scopes. | Microsoft Graph now offers Teams administration APIs: Teams User Configuration API (V1.0), Number Management, and Policy Assignment APIs (beta). These enable automation of user settings, phone number management, and policy assignments for Teams admins. APIs support delegated and application permissions in commercial environments. |
| 2026-01-21 | MC Last Updated | 10/10/2025 01:27:31 | 2026-01-20T18:37:01Z |
| 2026-01-21 | MC Messages | Microsoft Graph now includes APIs that support Teams administration scenarios through beta:
Teams User Configuration API Number Management APIs Policy Assignment APIs These APIs enable programmatic access to user configurations, telephone number management, and policy assignments-helping organizations automate and scale Teams management. They are designed to support extensibility, automation, and integrations with your existing tools and workflows. [When this will happen:] Please note that these APIs are currently available via the Microsoft Graph through beta. They are supported in commercial environments and accessible through both delegated and application permissions. | Updated January 20, 2026: We have updated the content. Thank you for your patience.
Microsoft Graph now includes APIs that support Teams administration scenarios through beta: Teams User Configuration API - Available through V1.0 Number Management APIs - Available through beta Policy Assignment APIs - Available through beta These APIs enable programmatic access to user configurations, telephone number management, and policy assignments-helping organizations automate and scale Teams management. They are designed to support extensibility, automation, and integrations with your existing tools and workflows. [When this will happen:] Please note that only Teams User Configuration API is currently available via the Microsoft Graph through V1.0, rest of the two APIs (Number Management and Policy Assignment) are currently available via the Microsoft Graph through beta. They are supported in commercial environments and accessible through both delegated and application permissions. |
| 2026-01-21 | MC How Affect | Who is affected: Admins managing Teams users, policies, or voice configurations.
What will happen: Teams User Configuration API: Retrieve detailed Teams settings for users, including effective policy assignments and voice attributes. Details: List userConfigurations Number Management APIs: Retrieve telephone number details, assign, and unassign telephone numbers. Details: List numberAssignments Policy Assignment APIs: Assign or unassign Teams policies for users. Details: teamsPolicyUserAssignment: assign | Who is affected: Admins managing Teams users, policies, or voice configurations.
What will happen: Teams User Configuration API: Retrieve detailed Teams settings for users, including effective policy assignments and voice attributes. Details: List userConfigurations - Microsoft Graph v1.0 | Microsoft Learn Number Management APIs: Retrieve telephone number details, assign, and unassign telephone numbers. Details: List numberAssignments Policy Assignment APIs: Assign or unassign Teams policies for users. Details: teamsPolicyUserAssignment: assign |
| 2026-01-21 | MC Title | Microsoft Teams: Microsoft Graph APIs for Teams administration now available in beta | (Updated) Microsoft Teams: Microsoft Graph APIs for Teams administration now available in beta |
| 2026-01-21 | MC End Time | 12/01/2025 09:00:00 | 2026-02-20T09:00:00Z |
Last updated 3 weeks ago ago
