Profile card properties path and permission changes in Microsoft Graph (beta)

Ruth Waithera

August 1st, 20230 0

Tenant admins and developers have been calling profile card properties APIs on the beta version of Microsoft Graph. As we are still in beta, we’re introducing breaking changes to these APIs.

About the breaking change

Currently, a tenant admin manages custom profile card properties by calling APIs on the Microsoft Graph URL https://graph.microsoft.com/beta/organization/{{organizationId}}/settings/profileCardProperties with permissions User.Read, User.Read.All, User.ReadWrite or User.ReadWrite.All.

Effective August 7, 2023 we’re changing the API path to https://graph.microsoft.com/beta/admin/people/profileCardProperties with new permissions PeopleSettings.Read.All and PeopleSettings.ReadWrite.All. The current API path will no longer be available. Please add the new permissions to your applications at your earliest convenience (note that adding new permissions will require admin consent).

The current path will become unavailable at that time. You should add the new permissions to your application, which will require admin consent.

For more information, see Add or delete custom attributes on a profile card (preview) – Microsoft Graph | Microsoft Learn.

What do I need to do?

Call profile card properties APIs on Microsoft Graph path https://graph.microsoft.com/beta/admin/people/profileCardProperties.
For get and list APIs, use permission PeopleSettings.Read.All.
For create, update, and delete APIs, use permission PeopleSettings.ReadWrite.All.

The requirement for Global Administrator role will stay the same.