{"id":1594,"date":"2016-06-09T16:43:19","date_gmt":"2016-06-09T16:43:19","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=1594"},"modified":"2016-06-09T16:43:19","modified_gmt":"2016-06-09T16:43:19","slug":"upcoming-changes-to-contacts-and-people-apis","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/upcoming-changes-to-contacts-and-people-apis\/","title":{"rendered":"Upcoming changes to Contacts and People APIs"},"content":{"rendered":"<p>This is an update about breaking changes that we are making that only impact <strong><u>Contacts and People APIs<\/u><\/strong> on the Outlook REST API Beta endpoints.<\/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 roll-out to PROD 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 &#8211; Collection(ComplexType: Website)<\/li>\n<li>Phones \u2013 Collection (ComplexType: Phone)<\/li>\n<li>PostalAddress \u2013 Collection(ComplexType: PhysicalAddress)<\/li>\n<li>WeddingAnniversary \u2013 Edm.Date<\/li>\n<li>Gender \u2013 Edm.String<\/li>\n<\/ul>\n<p><strong>Properties renamed in people:<\/strong><\/p>\n<ul>\n<li>\u00a0Renamed 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\n<ul>\n<li>Previous: BusinessHomePage, PersonalHomePage, Other<\/li>\n<li>New: Other, Home, Work, Blog, Profile<\/li>\n<\/ul>\n<\/li>\n<li>Phone enum types changed\n<ul>\n<li>Properties removed: Unknown, Car, Callback, Primary, Telex, TTYTDD, OrganizationMain<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<p><strong>Mapping of old property to new property:<\/strong><\/p>\n<table border=\"1\" cellpadding=\"10\">\n<tbody>\n<tr>\n<td width=\"250\"><strong>\u00a0 Old Property<\/strong><\/td>\n<td width=\"348\"><strong>\u00a0 New Property<\/strong><\/td>\n<\/tr>\n<tr>\n<td width=\"250\">\u00a0\u00a0BusinessHomePage<\/td>\n<td width=\"348\">\u00a0 Websites (Website.Type == Work)<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">\u00a0 HomePhones<\/td>\n<td width=\"348\">\u00a0 Phones (Phone.Type == Home)<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">\u00a0\u00a0MobilePhone1<\/td>\n<td width=\"348\">\u00a0 Phones (Phone.Type == Mobile)<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">\u00a0\u00a0BusinessPhones<\/td>\n<td width=\"348\">\u00a0 Phones (Phone.Type == Business)<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">\u00a0\u00a0HomeAddress<\/td>\n<td width=\"348\">\u00a0 PostalAddresses (PhysicalAddress.Type == Home)<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">\u00a0\u00a0BusinessAddress<\/td>\n<td width=\"348\">\u00a0 PostalAddresses (PhysicalAddress.Type == Business)<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">\u00a0\u00a0OtherAddress<\/td>\n<td width=\"348\">\u00a0 PostalAddresses (PhysicalAddress.Type == Other)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>&#8211; Monil Shah on behalf of the Contacts and People API team<\/p>\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 Outlook REST API Beta endpoints. It is a schema change where a few properties are being removed and corresponding collections are being added.<\/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-1594","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 Outlook REST API Beta endpoints. It is a schema change where a few properties are being removed and corresponding collections are being added.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1594","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=1594"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/1594\/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=1594"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=1594"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=1594"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}