Microsoft introduces Viva Engage Role Management APIs in Microsoft Graph Beta, enabling admins to automate role assignments and management beyond Entra-defined roles. These APIs support app-only and delegated access, streamlining Viva Engage user role administration with enhanced automation and control. Unique :

Introducing Viva Engage Role Management APIs on Microsoft Graph
Microsoft just rolled out new Viva Engage Role Management APIs in the Microsoft Graph Beta. This update is a game-changer for admins and power users who want to automate role assignments within Viva Engage. If you’ve been waiting to streamline role management without juggling multiple tools, this is your moment.
What’s New?
The new APIs let you read, assign, and demote users from specific Viva Engage roles that aren’t defined in Entra. Previously, roles like Yammer Administrator and Knowledge Manager were supported via Entra, but now these fresh role types—Corporate Communicator, Network Administrator, and Verified Administrator—are fully manageable through Microsoft Graph.
“These APIs will help admins and those with appropriate non-admin privileges to automate the role assignments, reading, assigning, and demoting users.” – Microsoft Viva Engage Team
Both app-delegated (user auth) and app-only access are supported, giving you flexibility to integrate role management into your workflows or apps seamlessly.
Major Updates & How to Get Started
To test these APIs, you’ll need admin access and a registered Azure AD app. Here’s a quick rundown:
- Register an app in Azure Active Directory (Entra) and configure authentication tokens.
- Request the right API permissions—either delegated or application permissions depending on your use case.
- Admin approval is mandatory before your app can use these permissions.
- Use Microsoft Graph Explorer to send POST and GET requests for assigning roles and reading role assignments.
For example, adding a user as a Corporate Communicator involves sending a POST request with the user’s Entra Object ID. A successful request returns a “204 No Content” response, confirming the role assignment.
Role IDs to Know
- Corporate Communicator: 77aa47ad-96fe-4ecc-8024-fd1ac5e28f17
- Network Administrator: ec759127-089f-4f91-8dfc-03a30b51cb38
- Verified Administrator: 966b8ec4-6457-4f22-bd3c-5a2520e98f4a
Why This Matters
This update simplifies managing Viva Engage roles without relying solely on Entra. It empowers admins and select users to automate tasks, saving time and reducing manual errors. Plus, it opens doors for custom integrations and advanced workflows.
“Feel free to try out these APIs and reach out to us with your feedback.” – Microsoft Viva Engage Team
If you’re a developer or IT pro working with Microsoft 365 ecosystems, this is a must-try. Check out the official Microsoft Graph REST API beta documentation for detailed guidance and start experimenting today.
Stay tuned for more updates as Microsoft continues to enhance Viva Engage’s capabilities!
From the New blog articles in Microsoft Community Hub