Changes to Contacts and People APIs

Microsoft Graph team

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.

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.

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 Microsoft Graph and Outlook teams

Feedback usabilla icon