{"id":21516,"date":"2024-05-24T08:28:54","date_gmt":"2024-05-24T15:28:54","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=21516"},"modified":"2024-05-24T08:28:54","modified_gmt":"2024-05-24T15:28:54","slug":"microsoft-graph-town-hall-apis-now-available-in-beta","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/microsoft-graph-town-hall-apis-now-available-in-beta\/","title":{"rendered":"Microsoft Graph town hall APIs now available in beta"},"content":{"rendered":"<p>Microsoft Teams supports multiple types of scheduled real-time voice and video experiences, such as\u00a0<a href=\"https:\/\/learn.microsoft.com\/en-us\/microsoftteams\/quick-start-meetings-live-events#meetings\">meetings<\/a>,\u00a0<a href=\"https:\/\/learn.microsoft.com\/en-us\/microsoftteams\/quick-start-meetings-live-events#webinars\">webinars<\/a>, and\u00a0<a href=\"https:\/\/learn.microsoft.com\/en-us\/microsoftteams\/overview-meetings-webinars-town-halls#town-halls\">town halls<\/a>.\u00a0With the retirement of Teams live events in favor of <a href=\"https:\/\/techcommunity.microsoft.com\/t5\/microsoft-teams-blog\/introducing-town-halls-in-microsoft-teams-and-retiring-microsoft\/ba-p\/3925739\">Teams Town hall<\/a>, we\u2019re announcing the <strong>preview (beta) release of new Microsoft Graph town hall APIs.<\/strong><\/p>\n<p>With town halls, customers can host various types of internal and external events, including company-wide town halls, all hands and global team meetings, internal broadcasts, fireside chats, and more. Town halls provide a one-to-many format with advanced production capabilities and a structured approach for attendee engagement.<\/p>\n<p style=\"text-align: center;\"><a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/TownHall-img1.png\"><img decoding=\"async\" class=\"aligncenter wp-image-21518 size-full\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/TownHall-img1.png\" alt=\"The presenter view of a live Teams town hall\" width=\"952\" height=\"541\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/TownHall-img1.png 952w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/TownHall-img1-300x170.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/TownHall-img1-768x436.png 768w\" sizes=\"(max-width: 952px) 100vw, 952px\" \/><\/a><em>The presenter <\/em><em>view of a live Teams town hall<\/em><\/p>\n<p>The new Microsoft Graph town hall APIs enable you to support the following personas in your app:<\/p>\n<ul>\n<li><strong>Organizers<\/strong>\u00a0are 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.<\/li>\n<li><strong>Presenters<\/strong>\u00a0are employees (in your organization) or external participants who lead the town hall.<\/li>\n<li><strong>Attendees<\/strong>\u00a0who are either employees (in your organization) or external users who join the town hall via an email invitation with a join link or is shared the join link.<\/li>\n<\/ul>\n<h2>About the new APIs for Teams town halls<\/h2>\n<p>The following table lists the Microsoft Graph town hall API resources and methods.<\/p>\n<table class=\" aligncenter\" style=\"width: 88.6588%;\">\n<tbody>\n<tr>\n<td style=\"width: 31.5452%;\" width=\"186\"><strong>Microsoft Graph resource<\/strong><\/td>\n<td style=\"width: 229.944%;\" width=\"432\"><strong>Methods \u00a0<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"width: 31.5452%;\" width=\"186\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/resources\/virtualeventtownhall?view=graph-rest-beta\">virtualEventTownhall<\/a><\/td>\n<td style=\"width: 229.944%;\" width=\"432\">\n<ul>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualeventsroot-post-townhalls?view=graph-rest-beta&amp;tabs=http\">Create<\/a> a town hall in draft mode.<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualeventtownhall-get?view=graph-rest-beta&amp;tabs=http\">Get<\/a> information about the town hall.<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualeventtownhall-update?view=graph-rest-beta&amp;tabs=http\">Update<\/a> the town hall information.<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualevent-cancel?view=graph-rest-beta&amp;tabs=http\">Cancel<\/a> a town hall.<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualevent-publish?view=graph-rest-beta&amp;tabs=http\">Publish<\/a> the town hall to be available for its audience.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 31.5452%;\" width=\"186\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/resources\/virtualeventpresenter?view=graph-rest-beta\">virtualEventPresenter<\/a><\/td>\n<td style=\"width: 229.944%;\" width=\"432\">\n<ul>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualevent-list-presenters?view=graph-rest-beta&amp;tabs=http\">List<\/a> presenters for the town hall.<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualevent-post-presenters?view=graph-rest-beta&amp;tabs=http\">Create<\/a> a presenter (internal or external of your organization) for the town hall.<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualeventpresenter-get?view=graph-rest-beta&amp;tabs=http\">Get<\/a> a presenter of a town hall\u2019s information.<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualeventpresenter-delete?view=graph-rest-beta&amp;tabs=http\">Delete<\/a> the presenter from a town hall.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<tr>\n<td style=\"width: 31.5452%;\" width=\"186\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/resources\/virtualeventsession?view=graph-rest-beta\">VirtualEventSession<\/a><\/td>\n<td style=\"width: 229.944%;\" width=\"432\">\n<ul>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualevent-list-sessions?view=graph-rest-beta&amp;tabs=http\">List<\/a> all the sessions in a town hall (currently, multisessions aren\u2019t supported).<\/li>\n<li style=\"text-align: left;\"><a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/virtualeventsession-get?view=graph-rest-beta&amp;tabs=http\">Get<\/a> a specific session in a town hall.<\/li>\n<\/ul>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>These APIs enable you to do the following:<\/p>\n<ul>\n<li>Automate town hall creation.<\/li>\n<li>Develop a third-party solution for event management to manage town halls.<\/li>\n<li>Transition from using the deprecated Teams live events APIs to using Town hall APIs.<\/li>\n<\/ul>\n<p>The Microsoft Graph API structure for town halls is consistent with the information architecture in the Microsoft Teams user experience. This ensures that end users can seamlessly use both the built-in Teams UI and custom applications that use Microsoft Graph APIs.<\/p>\n<p style=\"text-align: center;\"><a href=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/Townhall-img2.png\"><img decoding=\"async\" class=\"aligncenter wp-image-21519 size-full\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/Townhall-img2.png\" alt=\"The Teams built-in experience for creating a town hall, which can also be done programmatically by using Microsoft Graph town hall APIs\" width=\"952\" height=\"826\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/Townhall-img2.png 952w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/Townhall-img2-300x260.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2024\/05\/Townhall-img2-768x666.png 768w\" sizes=\"(max-width: 952px) 100vw, 952px\" \/><\/a><em>The Teams built-in experience for creating a town hall, which can also be done programmatically by using Microsoft Graph town hall APIs<\/em><\/p>\n<p>For more information and to get started with these APIs, see the\u00a0<a href=\"https:\/\/learn.microsoft.com\/en-us\/graph\/api\/resources\/virtualeventtownhall?view=graph-rest-beta\">virtualEventTownhall documentation<\/a>. For feedback on the beta APIs, post\u00a0in the\u00a0<a href=\"https:\/\/nam06.safelinks.protection.outlook.com\/?url=https%3A%2F%2Faka.ms%2Fgraphfeedback&amp;data=05%7C01%7CChristopher.Palmer%40microsoft.com%7C60311d0dd723486236cb08db45133335%7C72f988bf86f141af91ab2d7cd011db47%7C1%7C0%7C638179721051206313%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C3000%7C%7C%7C&amp;sdata=KtZTi8oQAUhhc5Mf1Dmi5Sky4T%2BIh4C3VVuJkI7rr8Y%3D&amp;reserved=0\">Feedback portal<\/a>.<\/p>\n<p>Happy coding!<\/p>\n<p><em>Follow us on <a href=\"http:\/\/twitter.com\/microsoft365dev\">X (Twitter) \/ @Microsoft365Dev<\/a>, <a href=\"https:\/\/www.linkedin.com\/showcase\/microsoft365dev\">LinkedIn<\/a>, and subscribe to our <a href=\"https:\/\/www.youtube.com\/microsoft365developer\">YouTube channel<\/a> to stay up to date on the latest developer news and announcements.<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>With the retirement of Teams live events in favor of Teams town hall, we\u2019re announcing the preview (beta) release of new Microsoft Graph town hall APIs.<\/p>\n","protected":false},"author":121762,"featured_media":21532,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3,128],"tags":[317,318],"class_list":["post-21516","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","category-microsoft-teams","tag-microsoft-graph-town-hall-apis","tag-teams-town-hall"],"acf":[],"blog_post_summary":"<p>With the retirement of Teams live events in favor of Teams town hall, we\u2019re announcing the preview (beta) release of new Microsoft Graph town hall APIs.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/21516","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/121762"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=21516"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/21516\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/21532"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=21516"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=21516"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=21516"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}