Microsoft Teams supports multiple types of scheduled real-time voice and video experiences. These range from ad hoc meetings suitable for a small number of participants to large structured virtual events like webinars and town halls with thousands of attendees. 

The following table provides a comparison of the types of meetings that Teams supports.   

 To learn more about the differences between each meeting type to help you choose the one that is best suited for your use case, see the feature comparison chart.  

Microsoft Graph for online meetings are already generally available. Developers can use these APIs to programmatically schedule online meetings with the appropriate meeting options. Today, we’re announcing the general availability of new Teams town hall APIs. 

What’s new?  

The following resources are now generally available: 

• virtualEventTownhall – Used to create, get, update, publish, and cancel a Teams town hall.  

• virtualEventPresenter – Used to create, get, list, update, and delete a presenter for a Teams town hall.  

• virtualEventSession – A town hall created via Microsoft Graph APIs has one session that inherits the properties of online meetings.  

Town hall personas 

To make the best use of the Teams town hall APIs, it’s helpful to understand the personas for the users who access the Teams town hall experience:  

• Organizers are employees (in your organization) who manage the town hall. They are the authority on when town halls take place and who participates. They configure town hall details such as title, theme, attendee experience, and email rules. 
• Presenters are employees (in your organization) or external participants who lead the town hall. 
• Attendees are either employees (in your organization) or external users who join the town hall and are either invited via email or the link to the town hall event is shared with them.  
• Teams tenant administrator must authorize custom applications with appropriate permissions.   

Solutions you can build  

The following table lists some solutions you can build by using the Teams client and Microsoft Graph town hall APIs. 

Data sync  

The following table lists the Teams client setup and the Microsoft Graph APIs to use to implement a town hall data sync solution.  

Create/update/delete 

The following table lists the Teams client setup and the Microsoft Graph APIs to use to implement a custom application to programmatically create, update, or delete town halls.   

Email communication 

The following table lists the Teams client setup and the Microsoft Graph APIs to use to implement a customized email communication experience for town halls.  

To learn how to authenticate and get your app authorized to use Microsoft Graph, see Authentication and authorization basics.