Share via

Upcoming changes to Contacts and People APIs

  • Article

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. The changes are outlined below and will roll-out to PROD over the next couple of weeks.

Properties removed from contacts:

  • BusinessHomePage
  • HomePhones
  • MobilePhone1
  • BusinessPhones
  • HomeAddress
  • BusinessAddress
  • OtherAddress

Properties added to contacts:

  • Websites - Collection(ComplexType: Website)
  • Phones – Collection (ComplexType: Phone)
  • PostalAddress – Collection(ComplexType: PhysicalAddress)
  • WeddingAnniversary – Edm.Date
  • Gender – Edm.String

Properties renamed in people:

  •  Renamed WebSite to Websites

Changes in both:

  • Websites enum types changed
    • Previous: BusinessHomePage, PersonalHomePage, Other
    • New: Other, Home, Work, Blog, Profile
  • Phone enum types changed
    • Properties removed: Unknown, Car, Callback, Primary, Telex, TTYTDD, OrganizationMain

Mapping of old property to new property:

  Old Property   New Property
  BusinessHomePage   Websites (Website.Type == Work)
  HomePhones   Phones (Phone.Type == Home)
  MobilePhone1   Phones (Phone.Type == Mobile)
  BusinessPhones   Phones (Phone.Type == Business)
  HomeAddress   PostalAddresses (PhysicalAddress.Type == Home)
  BusinessAddress   PostalAddresses (PhysicalAddress.Type == Business)
  OtherAddress   PostalAddresses (PhysicalAddress.Type == Other)

 

- Monil Shah on behalf of the Contacts and People API team

Comments

  • Anonymous
    June 16, 2016
    I have lost all my contacts information and cannot even create new addresses as the People part of Outlook is totally blank
    • Anonymous
      June 21, 2016
      Pauline, your best bet is to provide this information directly from within Outlook using the "smiley" button in the top-right corner.
      • Anonymous
        November 06, 2016
        Hi Jason, There's no smiley button in the top right corner of my outlook screen; just a speech bubble, a bell, a cog, a question mark and a person silhouette.
  • Anonymous
    June 18, 2016
    Hello:We need to have the ability to have one click entry of multiple addresses in Contacts, i.e. groups. like previous versions of Outlook.PLEASE!
    • Anonymous
      June 21, 2016
      Bruce, your best bet is to provide this feedback directly from within Outlook using the "smiley" button in the top-right corner.