{"id":839,"date":"2016-07-07T00:00:00","date_gmt":"2016-07-07T00:00:00","guid":{"rendered":"http:\/\/officedevblogs.wpengine.com\/?p=839"},"modified":"2016-07-07T00:00:00","modified_gmt":"2016-07-07T00:00:00","slug":"changes-to-contacts-and-people-apis","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/changes-to-contacts-and-people-apis\/","title":{"rendered":"Changes to Contacts and People APIs"},"content":{"rendered":"<div id=\"body-content\">\n<p>This is an update about breaking changes that we are making that only impact <strong><span style=\"text-decoration: underline\">Contacts and People APIs<\/span><\/strong> on the Microsoft Graph REST API Beta endpoint.<\/p>\n<p>It is a schema change where a few properties are being removed and corresponding collections are being added. The changes are outlined below and will be deployed world wide over the next couple of weeks.<\/p>\n<p><strong>Properties removed from contacts:<\/strong><\/p>\n<ul>\n<li>businessHomePage<\/li>\n<li>homePhones<\/li>\n<li>mobilePhone1<\/li>\n<li>businessPhones<\/li>\n<li>homeAddress<\/li>\n<li>businessAddress<\/li>\n<li>otherAddress<\/li>\n<\/ul>\n<p><strong>Properties added to contacts:<\/strong><\/p>\n<ul>\n<li>websites &ndash; Collection(ComplexType: website)<\/li>\n<li>phones &ndash; Collection (ComplexType: phone)<\/li>\n<li>postalAddress &ndash; Collection(ComplexType: physicalAddress)<\/li>\n<li>weddingAnniversary &ndash; Edm.Date<\/li>\n<li>gender &ndash; Edm.String<\/li>\n<\/ul>\n<p><strong>Properties renamed in people:<\/strong><\/p>\n<ul>\n<li>&nbsp;Renamed web<strong>S<\/strong>ite to web<strong>s<\/strong>ites<\/li>\n<\/ul>\n<p><strong>Changes in both: <\/strong><\/p>\n<ul>\n<li>websites enum types changed<\/li>\n<ul>\n<li>Previous: businessHomePage, personalHomePage, other<\/li>\n<li>New: other, home, work, blog, profile<\/li>\n<\/ul>\n<li>phone enum types changed<\/li>\n<ul>\n<li>Properties removed: unknown, car, callback, primary, telex, TTYTDD, organizationMain<\/li>\n<\/ul>\n<\/ul>\n<p><strong>Mapping of old property to new property:<\/strong><\/p>\n<table width=\"561\" style=\"border-color: #000000\" border=\"1\">\n<tbody>\n<tr style=\"border-color: #000000\">\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p><strong>&nbsp; Old Property<\/strong><\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p><strong>&nbsp; New Property<\/strong><\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p>&nbsp;&nbsp;businessHomePage<\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p>&nbsp; websites (website.Type == work)<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p>&nbsp; homePhones<\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p>&nbsp; phones (phone.Type == home)<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p>&nbsp;&nbsp;mobilePhone1<\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p>&nbsp; phones (phone.Type == mobile)<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p>&nbsp;&nbsp;businessPhones<\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p>&nbsp; phones (phone.Type == business)<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p>&nbsp;&nbsp;homeAddress<\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p>&nbsp; postalAddresses (physicalAddress.Type == home)<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p>&nbsp;&nbsp;businessAddress<\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p>&nbsp; postalAddresses (physicalAddress.Type == business)<\/p>\n<\/td>\n<\/tr>\n<tr>\n<td width=\"100\" style=\"border-color: #000000;width: 100px;text-align: center;vertical-align: middle\">\n<p>&nbsp;&nbsp;otherAddress<\/p>\n<\/td>\n<td width=\"348\" style=\"border-color: #000000;width: 348px;text-align: center;vertical-align: middle\">\n<p>&nbsp; postalAddresses (physicalAddress.Type == other)<\/p>\n<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>\n<p><p>&nbsp;<\/p>\n<p><p>Monil Shah on behalf of the Microsoft Graph and Outlook teams<\/p>\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"<p>This is an update about breaking changes that we are making that only impact Contacts and People APIs on the Microsoft Graph REST API Beta endpoint.<\/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],"tags":[12],"class_list":["post-839","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-graph","tag-outlook"],"acf":[],"blog_post_summary":"<p>This is an update about breaking changes that we are making that only impact Contacts and People APIs on the Microsoft Graph REST API Beta endpoint.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/839","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=839"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/839\/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=839"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=839"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=839"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}