Table of Contents
Summary
- New APIs introduced in Microsoft Graph for Teams administration: Teams User Configuration, Number Management, and Policy Assignment.
- Programmatic access allows automation and scalability in managing Teams settings, telephone numbers, and policies.
- Admins can retrieve user settings, manage telephone numbers, and assign or unassign policies through these APIs.
- Administrators should explore the APIs via Microsoft Graph beta endpoints and ensure appropriate permission scopes are used.
Admin Impact: Medium
User Impact: Low
Release Start: 10 Oct 2025
Release End: 10 Oct 2025
Services: Teams
Category: Stay informed
Tags: New Feature, User Adoption, Admin Action
History
10/9/2025: Item Added to Message Center
Microsoft Message
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.
How this affects your organization
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
What you can do to 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: [email protected]
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.