Team Online Meeting


Namespace: microsoft.graph

Create an online meeting on behalf of a user by using the object ID (OID) in the user token.

Mar 10, 2021 “Can You Hear Me Now?” is one of the best online team building games. You play this game in a virtual conference room, and nominate one person to be the speaker and the rest are artists. Emoji check-in 🥰 A simple round table team check-in but this time instead of a one-word.


The meeting does not show up on the user's calendar.


One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Permission typePermissions (from least to most privileged)
Delegated (work or school account)OnlineMeetings.ReadWrite
Delegated (personal Microsoft account)Not Supported


* Administrators must create an application access policy and grant it to a user, authorizing the app configured in the policy to create an online meeting on behalf of that user (user ID specified in the request path).

HTTP request

Request when using a delegated token:

Request when using an application token:


userId is the object ID of a user in Azure user management portal. See more details in application access policy.

Request headers

AuthorizationBearer {token}. Required.
Content-typeapplication/json. Required.
Accept-LanguageLanguage. Optional.

If the request contains an Accept-Language HTTP header, the content of joinInformation will be in the language and locale variant specified in the Accept-Language header. The default content will be in English.

Request body

Microsoft team online meeting

In the request body, supply a JSON representation of an onlineMeeting object.


If successful, this method returns a 201 Created response code and an onlineMeeting object in the response body.



The following example creates an online meeting with a user token.


Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.

Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.


Note: The response object shown here might be shortened for readability.


If 'Accept-Language: ja' is specified to indicate Japanese, for example, the response will include the following.


In this training, we introduce meetings in Microsoft Teams. We’ll cover thecapabilities of meetings in Teams in addition to requirements and planningconsiderations for Teams.


This tutorial includes links to existing content to help connect you with the latest, most up-to-date information. For an optimal learning experience, follow the links to learn and apply. If a link is labeled as “additional information,” you can consider it optional.

This training is for you if you’re:

  • An IT pro
  • Responsible for planning, deploying, or managing Teams
  • Interested in meetings in Teams

We’ll cover the following sections:

Online Team Meeting Themes

  • Meetings and meeting types in Teams
  • Requirements for meetings
  • Reporting

The following information is out of scope:

  • Meetings can include a feature where participants are able to join meetingsfrom a regular phone line. This feature, called Audio Conferencing, is outof scope for the training.


Microsoft Teams is evolving on a regular basis—new features and functionality are added frequently. Please monitor the following resources to stay up-to-date:

  • Follow the Teams Blog.
  • Read the Teams Roadmap.
  • Learn about the latest released features in the Release Notes.
  • Participate in the Microsoft Teams technical community to get your feature questions answered.

If you have any questions or feedback about this training, please:

  • Post in the comments section at the bottom of the “Next steps” page of thistutorial.

To give us product feedback about Teams, such as ideas for new features, pleasevisit UserVoice.

Meetings in Teams

To understand meetings in Teams, see the following:

  • “Have meetings” in Meetings andcalls(estimated reading time 6 minutes)

  • Meetnowvideo (1:45 minutes)

  • Scheduledmeetingsvideo (1:45 minutes)

  • 9 tips for meeting with MicrosoftTeamsto learn about the meeting lobby, joining meetings anonymously, and more(estimated reading time 6 minutes)

Scenario - Meeting types

Garth works for Contoso, a company that has multiple offices. Garth needs toconnect to people in other office locations on a regular basis:

  • His project team meets every Monday for an hour. Because they already have adedicated channel for their project in Microsoft Teams, Garth schedules a'Channel Meeting' for this regular sync. This has multiple benefits forGarth and his team:
    • All members of the team are automatically invited.
    • Any meeting-related discussions before, during, or after the meeting arepart of the channel discussion.
    • The meeting and the discussion is visible to everyone who is a member ofthe team.
    • Turn on live captions for meetings and live events. In addition, they turn on subtitles in live events. These features increase inclusivity, productivity, and comprehension.
  • Garth also needs to sync with individual people but doesn’t want thesemeetings to be visible to others. For these purposes, Garth schedules a'Private Meeting'.Private meetings allow Garth to initiate a chat before the meeting takesplace. This pre-meeting experience helps make the meeting more effectivebecause Garth can share material beforehand or discuss the agenda with keyteam members. The same chat is also available during the meeting to capturenotes, and can be used afterward for any follow-ups.
  • Sometimes the team has lively discussions in their channel, and Garth needsthem to come to a quick decision. He determines that while everyone istyping, a video call might be the more effective way to communicate. In thissituation, Garth schedules an ad-hoc meeting by selecting Meet Now inthe current conversation.

In Teams, meeting organizers can end a meeting for all meeting participants. This is useful in scenarios such as the following:

  • Educators can ensure that students don't stay in a meeting unsupervised after a class is finished.
  • For meetings that are being recorded, such as webinars, meeting organizers can ensure that the recording ends when the meeting ends.

For example, when the meeting is finished, Garth can click End meeting from within the meeting in Teams to end it and remove all participants from it.

Meeting clients

Joining meetings is possible from a variety of clients. Review Get clients forMicrosoft Teams(estimated reading time 3 minutes) to understand which platforms Teams isavailable for.

Online Team Meeting Tools

In addition, by using Audio Conferencing, participants can attend meetings fromregular phones by dialing in to the meeting or dialing out from the meeting.Details about Audio Conferencing will be covered in a dedicated training.

In Outlook for Windows, you can use an add-in to schedule meetings directly fromyour calendar. Review Use the Teams Meeting add-in inOutlook(estimated reading time 2 minutes).

Requirements and considerations for meetings


Although you can hold meetings without having any additional licenses—all youneed is a license for Microsoft Teams—some scenarios do require additionallicensing.

Audio Conferencing, which lets participants join Teams meetings from a regularphone, requires an additional license. This will be addressed in a dedicatedtraining on Audio Conferencing.

For more information, see Microsoft Teams service description.

Bandwidth and media flow

In Teams, there are two ways to initiate real-time communication:

  • A user can call another user directly
  • A user can create a meeting (ad hoc or scheduled)For calls, the media (audio, video, or desktop or application sharing) travel asdirectly as possible. If, for example, there’s no firewall between two users(for example, both sit inside the same network), media traffic travels directlyfrom one user to the other. If a firewall blocks direct traffic between theusers, the traffic will be sent via a relay.

For meetings, all traffic is sent first to the conferencing service that ishomed in Office 365. Audio traffic is collected there and mixed before beingsent back; video traffic and application or desktop sharing are received anddistributed to the attendees.

Important!During the duration of the COVID-19 outbreak, we recommend that users join meetings by clicking the Join Teams Meeting button rather than dialing in by using the PSTN conference numbers or by using Call me at. This is primarily because of congestion in the telephony infrastructures of countries impacted by COVID-19. By avoiding PSTN calls, you’ll likely experience better audio quality.

Planning bandwidth isn’t covered in this training, but it will be crucial forthe user experience.

For more information, see Prepare your organization's network forTeams.

Exchange dependencies

For customers using Exchange Server on-premises, there might be (depending on theversion of Exchange Server) some limitations when it comes to creating andviewing meetings from the Teams client, but also when it comes to compliance.Review How Exchange and Microsoft Teamsinteract(estimated reading time 3 minutes) to understand potential limitations.

End meetings for all participants

Meeting organizers can end a meeting for all participants by clicking End meeting from within the meeting. This is helpful in scenarios such as the following:

  • Educators can ensure that students don't stay in a meeting unsupervised after a class is finished.
  • For meetings that are being recorded, such as webinars, meeting organizers can ensure that the recording ends when the meeting ends.

To learn more, see End a Teams meeting for everyone in attendance.

Change participant settings for a meeting

Meeting organizers can change the default participant settings for a specific meeting in Meeting options. There are three ways to get there:

  • Go to the Calendar in Teams, select a meeting, and then select Meeting options.
  • In a meeting invitation, select Meeting options.
  • Select Show participants to open the People pane, and then select Manage Permissions.

To learn more, see Change participant settings for a Teams meeting.

Meeting configuration options

As an IT administrator, you can set meeting policies and settings to define the meeting experience.

Meeting policies

Use Teams meeting policies to control the features that are available tomeeting participants for meetings that are scheduled by users in your organization. To learn more, seeManage meeting policies in Teams(estimated reading time 16 minutes).

Meeting settings

Use Teams meetings settings to control whether anonymous users can join Teams meetings, customize meeting invitations,and if you want to enable Quality of Service (QoS), set port ranges for real-time traffic. These settings apply to allTeams meetings that users schedule in your organization. To learn more, see Manage meeting settings in Teams.(estimated time reading time 4 minutes).

Exercise - Configure meetings

In this exercise, you’ll have the chance to test meetings in Teams. Although wedon’t describe how to perform every action, we recommend some scenarios to tryout.


  • An Office 365 organization with appropriate licenses to use Teams
    • We strongly recommend that you use a dedicated test tenant.
    • If you don’t have a test tenant, you can sign up for a trial tenant atOffice 365 Enterprise E5Trial.
    • Don’t run any tests in your production environment. Changing settings orpolicies might have a negative impact on all users and might affecttheir user experience.
  • At least two endpoints
  • This can be two PCs, but you can also use the client on your mobilephone.

Suggested scenarios to test

  • Schedule different meeting types from within the Teams client: Channelmeetings, ad-hoc meetings, private meetings.
  • Schedule meetings by using the Outlook add-in.
  • For scheduled meetings, initiate a chat before the meeting begins (todiscuss the agenda, for example).
  • Join meetings and test different scenarios and workloads: For example, audio only, video,desktop sharing.
  • Join a meeting from a browser without signing in to your tenant (you mightwant to use “InPrivate” browsing) to see what it’s like to join a meetinganonymously.
  • Sign in to the Microsoft Teams admin center and change some of the settings for meetings(for example, disable scheduling for private meetings). How does this affectthe user experience?
  • As the meeting organizer, end a meeting for all participants.


From a reporting perspective, there are two areas to look at:

  • Usage: How many meetings take place?
  • Quality: What is the quality of the meetings?

Online Team Meeting Activities

You should carefully monitor both areas:

  • Low usage means that users, for one reason or another, aren’t using theproduct. You can only determine the reasons by doing additionalinvestigation. Reasons can range from the perception that meetings arefalling short of user requirements, to a lack of awareness or training, toquality problems.
  • Low quality, on the other hand, means that there are issues withconnectivity between users and Office 365. Low quality can lead to bad userexperience and lower usage.Refer to Microsoft 365 Reports in the Admin Center - Microsoft Teams useractivity(estimated reading time 5 minutes) to learn more about the usage reports.

Managing quality is outside of the scope of this training, but see the followingtraining material:

Join Teams Meeting Online

  • For information about the role of Quality Champion, see Quality championrole.
  • For information about the Call Quality Dashboard, see Investigate MediaQuality using CQD.

Next steps

We covered the following key learnings in this training:

  • Meetings and meeting types in Teams
  • Requirements for meetings
  • Reporting

Next steps

  1. Start using meetings in Teams.
  2. Send us feedback:
    • Post in the comments section at the bottom of this page.
    • To give us Teams product feedback or to request a new feature, go to Teams UserVoice.
  3. Stay up to date:
    • Follow the Teams Blog.
    • Read the Teams Roadmap.
    • Learn about the latest released features in the Release Notes
  4. Explore more training and tutorials.

Click Here To Join The Meeting

Have an issue with this section? If so, please give us some feedback so we can improve this section.