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
