MC1169072 - Microsoft Teams: Microsoft Graph APIs for Teams administration now available in beta

Message ID

MC1169072

View in Message Center

Service

Microsoft Teams

Published

Oct 9, 2025

Tag

New feature

User impact

Admin impact

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.

More information

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.