{"id":4769,"date":"2020-06-08T12:06:11","date_gmt":"2020-06-08T19:06:11","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=4769"},"modified":"2020-06-08T12:06:11","modified_gmt":"2020-06-08T19:06:11","slug":"announcing-support-for-new-groups-properties-via-microsoft-graph-api","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/announcing-support-for-new-groups-properties-via-microsoft-graph-api\/","title":{"rendered":"Announcing support for new Groups properties via Microsoft Graph API"},"content":{"rendered":"<p>We are excited to announce that Microsoft 365 Groups now supports more flexible methods of hiding and showing groups in any Outlook client or the address book. We have added to the Group Resource Type on the production endpoint in Microsoft Graph: <strong>hideFromOutlookClients<\/strong> and <strong>hideFromAddressLists<\/strong>. Previously, these properties could only be changed via PowerShell. We now provide access to these properties via Microsoft Graph, which will help support additional customizations through <a href=\"https:\/\/preview.flow.microsoft.com\/en-us\/\">Power Automate<\/a> and 3<sup>rd<\/sup> party applications.<\/p>\n<p>Setting hideFromOutlookClients to True (which also sets <strong>hideFromAddressLists<\/strong> to True) prevents the group from showing in the Outlook left-hand navigation, prevents the group name from resolving during message creation, and prevents the group from showing in the Global Address List (GAL). If hideFromOutlookClients is set to False, hideFromAddressLists will also be set to False.<\/p>\n<p>Setting <strong>hideFromAddressLists<\/strong> by itself controls whether the group is hidden or shown in the GAL, but it won\u2019t affect the Outlook left-hand navigation or name resolution during message creation. Changing <strong>hideFromAddressLists<\/strong> by itself does not change the value of <strong>hideFromOutlookClients<\/strong>.<\/p>\n<p>The default value for both properties is False, and they are only retrieved when using $select. The following example shows how to use the GET method to retrieve values for <strong>hideFromOutlookClients<\/strong> and h<strong>ideFromAddressLists<\/strong> using Graph Explorer.<\/p>\n<p>Sample query: https:\/\/graph.microsoft.com\/v1.0\/groups\/ed8083cb-8540-46f9-b817-46866469695d?$select=displayName,description,hideFromOutlookClients,hideFromAddressLists<\/p>\n<p><img decoding=\"async\" class=\"alignleft wp-image-4770\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/1-1024x36.png\" alt=\"\u201cSample Query to retrieve hideFromOutlookClients and hideFromAddressLists using $select\u201d&gt;\" width=\"650\" height=\"23\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/1-1024x36.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/1-300x11.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/1-768x27.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/1-1536x54.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/1.png 1880w\" sizes=\"(max-width: 650px) 100vw, 650px\" \/><\/p>\n<p>&nbsp;<\/p>\n<p><img decoding=\"async\" class=\"alignleft wp-image-4771\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/2-1024x192.png\" alt=\"\u201cGET query response used to view hideFromOutlookClients and hideFromAddressLists properties\u201d&gt;\" width=\"650\" height=\"122\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/2-1024x192.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/2-300x56.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/2-768x144.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/2-1536x288.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/2.png 1795w\" sizes=\"(max-width: 650px) 100vw, 650px\" \/><\/p>\n<p>These values can be updated using methods like PATCH, as shown in the following example:<\/p>\n<p><img decoding=\"async\" class=\"alignleft wp-image-4792\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/G3-1-1024x122.png\" alt=\"\u201cExample using PATCH to set hideFromOutlookClients to false\u201d\" width=\"650\" height=\"77\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/G3-1-1024x122.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/G3-1-300x36.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/G3-1-768x91.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/G3-1-1536x183.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/G3-1.png 1876w\" sizes=\"(max-width: 650px) 100vw, 650px\" \/><\/p>\n<p>&nbsp;<\/p>\n<p>In the response, hideFromOutlookClients is now set to <strong>false<\/strong>. Both properties are updated:<\/p>\n<p><img decoding=\"async\" class=\"alignleft wp-image-4773\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/4-1024x194.png\" alt=\"\u201cUsing GET query to view changes made to hideFromOutlookClients and hideFromAddressLists properties\u201d&gt;\" width=\"650\" height=\"123\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/4-1024x194.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/4-300x57.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/4-768x146.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/4-1536x291.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/4.png 1794w\" sizes=\"(max-width: 650px) 100vw, 650px\" \/><\/p>\n<p>Updating just hideFromAddressLists will not have any effect on hideFromOutlookClients.<\/p>\n<p><img decoding=\"async\" class=\"alignleft wp-image-4774\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/5-1024x125.png\" alt=\"\u201cExample using PATCH to set hideFromAddressLists to true\u201d\" width=\"650\" height=\"80\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/5-1024x125.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/5-300x37.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/5-768x94.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/5-1536x188.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/5.png 1879w\" sizes=\"(max-width: 650px) 100vw, 650px\" \/><\/p>\n<p><img decoding=\"async\" class=\"alignleft wp-image-4775\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/6-1024x192.png\" alt=\"\u201cUsing GET query to view changes made to hideFromOutlookClients and hideFromAddressLists properties\u201d&gt;\" width=\"650\" height=\"122\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/6-1024x192.png 1024w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/6-300x56.png 300w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/6-768x144.png 768w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/6-1536x287.png 1536w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2020\/06\/6.png 1790w\" sizes=\"(max-width: 650px) 100vw, 650px\" \/><\/p>\n<p>You can find detailed API documentation <a href=\"https:\/\/docs.microsoft.com\/en-us\/graph\/api\/resources\/group?view=graph-rest-1.0\">here<\/a>.\u00a0 As always, we welcome your <a href=\"https:\/\/microsoftgraph.uservoice.com\/forums\/920506-microsoft-graph-feature-requests\/filters\/top?category_id=359569\">feedback<\/a>!<\/p>\n<p>Mike McLean\nPrincipal Program Manager\nMicrosoft 365 Groups<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>We are excited to announce that Microsoft 365 Groups now supports more flexible methods of hiding and showing groups in any Outlook client or the address book.<\/p>\n","protected":false},"author":69077,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[3,128],"tags":[12],"class_list":["post-4769","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","category-microsoft-teams","tag-outlook"],"acf":[],"blog_post_summary":"<p>We are excited to announce that Microsoft 365 Groups now supports more flexible methods of hiding and showing groups in any Outlook client or the address book.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/4769","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\/69077"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=4769"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/4769\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=4769"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=4769"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=4769"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}