You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: api-reference/beta/api/peopleadminsettings-post-profilecardproperties.md
+6-34Lines changed: 6 additions & 34 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,7 +5,7 @@ ms.localizationpriority: medium
5
5
author: "rwaithera"
6
6
ms.subservice: "people"
7
7
doc_type: "apiPageType"
8
-
ms.date: 09/19/2024
8
+
ms.date: 02/25/2026
9
9
---
10
10
11
11
# Create profileCardProperty
@@ -58,8 +58,9 @@ You can specify the following properties when you create a **profileCardProperty
58
58
59
59
|Property|Type|Description|
60
60
|:---|:---|:---|
61
-
|annotations|[profileCardAnnotation](../resources/profilecardannotation.md) collection|Any alternative or localized labels that an administrator chose to specify.|
62
-
|directoryPropertyName|String|The name of the directory property that is intended to surface on the profile card.|
61
+
|annotations|[profileCardAnnotation](../resources/profilecardannotation.md) collection|Any alternative or localized labels that an administrator chose to specify. Optional.|
62
+
|directoryPropertyName|String|The name of the directory property that is intended to surface on the profile card. Required.|
63
+
|isVisible|Boolean|Indicates whether the given directory property should be shown on a user’s profile card. Optional.|
63
64
64
65
## Response
65
66
@@ -71,7 +72,6 @@ If successful, this method returns a `201 Created` response code and a new [prof
|annotations|profileCardAnnotation collection| Any alternative or localized labels an administrator chose to specify.|
56
-
|directoryPropertyName|String|The name of the directory property that is intended to surface on the profile card. |
55
+
|annotations|[profileCardAnnotation](../resources/profilecardannotation.md) collection| Any alternative or localized labels an administrator chose to specify. Optional.|
56
+
|directoryPropertyName|String|The name of the directory property that is intended to surface on the profile card. Optional. |
57
+
|isVisible|Boolean|Indicates whether the given directory property should be shown on a user’s profile card. Optional.|
57
58
58
59
## Response
59
60
@@ -65,7 +66,6 @@ If successful, this method returns a `200 OK` response code and an updated [prof
65
66
66
67
The following example adds a localized label `Kostnadssenter` for the locale `no`.
|annotations |[profileCardAnnotation](profilecardannotation.md) collection | Allows an administrator to set a custom display label for the directory property and localize it for the users in their tenant.|
38
38
|directoryPropertyName |String | Identifies a **profileCardProperty** resource in [Get](../api/profilecardproperty-get.md), [Update](../api/profilecardproperty-update.md), or [Delete](../api/profilecardproperty-delete.md) operations. Allows an administrator to surface hidden Microsoft Entra ID properties on the Microsoft 365 profile card within their tenant. When present, the Microsoft Entra ID field referenced in this property is visible to all users in your tenant on the contact pane of the profile card. Allowed values for this field are: `UserPrincipalName`, `Fax`, `StreetAddress`, `PostalCode`, `StateOrProvince`, `Alias`, `CustomAttribute1`, `CustomAttribute2`, `CustomAttribute3`, `CustomAttribute4`, `CustomAttribute5`, `CustomAttribute6`, `CustomAttribute7`, `CustomAttribute8`, `CustomAttribute9`, `CustomAttribute10`, `CustomAttribute11`, `CustomAttribute12`, `CustomAttribute13`, `CustomAttribute14`, `CustomAttribute15`. |
39
+
|isVisible|Boolean|Indicates whether the given directory property should be shown on a user’s profile card.|
39
40
40
41
## Relationships
41
42
@@ -56,6 +57,7 @@ The following JSON representation shows the resource type.
Copy file name to clipboardExpand all lines: changelog/Microsoft.People.json
+18Lines changed: 18 additions & 0 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,23 @@
1
1
{
2
2
"changelog": [
3
+
{
4
+
"ChangeList": [
5
+
{
6
+
"Id": "3de9aa4d-804f-47e0-9ea6-fb9ed7a669f8",
7
+
"ApiChange": "Property",
8
+
"ChangedApiName": "isVisible",
9
+
"ChangeType": "Addition",
10
+
"Description": "Added the **isVisible** property to the [profileCardProperty](https://learn.microsoft.com/en-us/graph/api/resources/profileCardProperty?view=graph-rest-beta) resource.",
Copy file name to clipboardExpand all lines: concepts/add-properties-profilecard.md
+2Lines changed: 2 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -62,6 +62,8 @@ You can add any of these attributes to the profile card by configuring your [peo
62
62
63
63
## Configure profile card properties using the Microsoft Graph REST API
64
64
65
+
Use the **annotations** and **directoryPropertyName** properties on **profileCardProperty** to configure profile card properties. You can also use the **isVisible** property to indicate whether the given directory property should be shown on a user’s profile card; this property is supported only in the Microsoft Graph beta API and requires the `/beta` endpoint.
66
+
65
67
### Example
66
68
67
69
The following example displays the `Alias` attribute on the profile card.
Copy file name to clipboardExpand all lines: concepts/whats-new-overview.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -45,6 +45,10 @@ Use the new Copilot change notifications API for meetings AI insights to subscri
45
45
- Added the [onVerifiedIdClaimValidationCustomExtension](/graph/api/resources/onverifiedidclaimvalidationcustomextension?view=graph-rest-beta&preserve-view=true) and [onVerifiedIdClaimValidationListener](/graph/api/resources/onverifiedidclaimvalidationlistener?view=graph-rest-beta&preserve-view=true) resource types and associated methods to support custom logic for claim validation from Verified ID credential presentations during authentication flows through Microsoft Entra custom authentication extensions in External ID.
46
46
- Added support for Microsoft 365 cross-tenant access policy capabilities that allow administrators to control access to Microsoft 365 resources and data when collaborating with external organizations. Use the [crossTenantAccessPolicyConfigurationDefault](/graph/api/resources/crosstenantaccesspolicyconfigurationdefault?view=graph-rest-beta&preserve-view=true) and [crossTenantAccessPolicyConfigurationPartner](/graph/api/resources/crosstenantaccesspolicyconfigurationpartner?view=graph-rest-beta&preserve-view=true) resources with the new **m365Capabilities** relationship to manage capabilities including profile sharing, calendar sharing, migration, mail tips, and Places booking across organizational boundaries.
47
47
48
+
### People and workplace intelligence | People admin settings
49
+
50
+
Use the **isVisible** property on [profileCardProperty](/graph/api/resources/profilecardproperty?view=graph-rest-beta&preserve-view=true) to indicate whether the given directory property should be shown on a user’s profile card.
0 commit comments