Skip to main content
Documentation
Documentation
Administrator Guide
Last Updated: 2026-07-10
Steps: Set Up Virtual Classroom Integration with Microsoft Teams

Steps: Set Up Virtual Classroom Integration with Microsoft Teams

  • Register a new application in the Microsoft Azure portal:
    • Take note of its
      Application (Client) ID
       value.
    • Give the application these API permissions:
    • OnlineMeetings.ReadWrite.All
    • User.Read.All
    • Add a
      Client Secret
       to this application.
    Note: To create calendar events, the integration needs ReadWrite access to a single mailbox defined in the tenant setup. Workday uses this to send calendar events to learners and instructors. See Configure Application Access Policy and Limit Application Permissions to Specific Exchange Online Mailboxes to configure policy rules using Microsoft Powershell to restrict ReadWrite access to one mailbox.
  • Workday adds the Client ID that you generate from Microsoft Azure to your tenant.
  • Configure policy rules using Microsoft PowerShell.
  • Create and configure a new integration system.
You want to integrate Workday Learning with Microsoft Teams so that you can create course offerings that include virtual classroom lessons for instructor-led training. This lesson type enables large, geographically diverse populations to join virtual classes for instructor-led training.
  1. Create an Integration System User (ISU) for virtual classroom integration with Microsoft Teams.
  2. Access the
    Create Integration System
     task.
    Add values for system name and template. We recommend you use the
    Workday-delivered Learning Virtual Classroom for MS Teams Template
     template.
    Security: The
    Integration Build
     domain in the Integration functional area.
  3. From the related actions menu of the
    View Integration System
     report, select
    Workday Account
    .
    Select
    Edit Account for Integration System
     and add your ISU on the Workday account.
  4. From the related actions menu of the
    View Integration System
     report, select
    Configure Integration Attributes for Integration System
    .
    Populate values for these fields:
    • Client ID
      : From your Microsoft Azure setup.
    • Client Secret
      : From your Microsoft Azure setup.
    • Tenant
      : Your Microsoft tenant ID.
    • Mailbox
      : To generate the Microsoft Teams link.
    Security: The
    Integration Build
     domain in the Integration functional area.
  5. Access the
    Manage Course Offering
     business process and navigate to the
    Edit Business Process Definition
     task from the related actions.
    Add a new step and select
    Integration
     for the
    Type
    . This action prompts you to configure the integration system. If you've followed these steps, you don't need to select
    Run as User
    , as the integration automatically selects your ISU. Select your integration, and click
    OK
    .
    Use the
    Integration System - Proposed
     report field to create a condition rule so that this step only runs when the associated lesson has selected the integration. We recommend using different condition rules when you enable more than 1 integration, or instance of the integration, so that the correct condition rule runs for the correct integration.
    These domains in the System functional area:
    • Business Process Administration
    • Manage: Business Process Definitions
  6. (Optional) Configure attendance synchronization.
    Give
    OnlineMeetingArtifact.Read.All
     API permission to the application in the Microsoft Azure portal.
    Access the
    Learning
     section of the
    Edit Tenant Setup – HCM
     task. From the
    Select Virtual Classroom Integrations
     prompt, select the Microsoft Teams integration you want to use.
    Enter values on the
    Minimum Percentage for Full Attendance
     and
    Minimum Percentage for Partial Attendance
     fields. Select the
    Track Non-Attendance for Virtual Classroom
     check box.
    Select
    Track Non-Attendance for Virtual Classroom
     only if you want to mark learners below the partial attendance threshold as
    Not Attended
    . If you only want to synchronize full and partial attendance, clear this check box.
  7. (Optional) Set an instructor as a co-organizer of virtual classroom meetings so that they can create and manage breakout rooms.
You can now create course offerings that include virtual classroom lessons for instructor-led training.
Workday doesn't support unlimited capacity for course offerings that include virtual classroom lessons with Microsoft Teams integration.
If you update an offering to a new version, validate virtual classroom setup and the meeting link on offerings that use the Microsoft Teams integration, and use
Edit Course Offering
 to restore the integration if needed.