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


  websites (website.Type == work)


  phones (phone.Type == home)


  phones (phone.Type == mobile)


  phones (phone.Type == business)


  postalAddresses (physicalAddress.Type == home)


  postalAddresses (physicalAddress.Type == business)


  postalAddresses (physicalAddress.Type == other)


Monil Shah on behalf of the Microsoft Graph and Outlook teams

Feedback usabilla icon