Use the employee learning API to integrate with Viva Learning

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Viva Learning is a centralized employee learning hub in Microsoft Teams that lets employees integrate learning and building skills into their work day. In Viva Learning, teams can discover, share, recommend, and learn from content libraries provided by both their organization and partners. They can quickly access assigned or recently completed learning content, and do all of this without leaving Microsoft Teams.

The employee learning API in Microsoft Graph enables apps to make content from a Learning Management System (LMS) or learning provider available in Viva Learning. Use the following resources to integrate with Viva Learning:

  • Learning provider to manage learning providers, including registering and deleting providers.
  • Learning content to upload and manage learning content metadata from your LMS or learning provider in Viva Learning.
  • Learning course activities to upload and manage learner course activity records from your LMS or learning provider in Viva Learning.

How do integrations work?

As administrators, you can integrate your content and learner records (employee assignments and completed course records) from your LMS or learning provider with Viva Learning, by using out-of-the-box integrations where Viva Learning can pull content metadata and learning records from your LMS or learning provider. You can also use the employee learning API in Microsoft Graph to push content metadata from your LMS or learning provider into Viva Learning.

When the content metadata, employee assignments, and their completed course records are uploaded to Viva Learning, they appear in Viva Learning in the following locations:

  • When the content metadata is synchronized, the content appears on the home page under the Browse coursesProviders section.
  • When the learning course activities are synchronized, assignments, recommendations, and self-learning course records appear on the My Learning tab. Based on progression, the status will move from In Progress to Completed.

The learning course activities for the learners can be discovered outside of Viva Learning via APIs.

Authorization

With the appropriate delegated or application employee learning permissions, your app can use the employee learning API to manage learning providers and their content for a learning hub in a tenant. For more information about access tokens, app registration, and delegated and application permissions, see Authentication and authorization basics.

Use cases for the employee learning API in Microsoft Graph

Use the employee learning APIs to do the following:

Next steps