| title | optionalClaims type |
|---|---|
| description | Declares the optional claims requested by an application. |
| ms.localizationpriority | medium |
| doc_type | resourcePageType |
| ms.subservice | entra-applications |
| author | Jackson-Woods |
| ms.date | 03/21/2024 |
Namespace: microsoft.graph
[!INCLUDE beta-disclaimer]
Declares the optional claims requested by an application. An application can configure optional claims to be returned in each of three types of tokens (ID token, access token, SAML 2 token) it can receive from the security token service. An application can configure a different set of optional claims to be returned in each token type. The optionalClaims property of the application is an optionalClaims object.
Application developers can configure optional claims in their Microsoft Entra apps to specify which claims they want in tokens sent to their application by the Microsoft security token service. See provide optional claims to your Microsoft Entra app for more information.
| Property | Type | Description |
|---|---|---|
| idToken | optionalClaim collection | The optional claims returned in the JWT ID token. |
| accessToken | optionalClaim collection | The optional claims returned in the JWT access token. |
| saml2Token | optionalClaim collection | The optional claims returned in the SAML token. |
None.
The following JSON representation shows the resource type.
{
"idToken": [{"@odata.type": "microsoft.graph.optionalClaim"}],
"accessToken": [{"@odata.type": "microsoft.graph.optionalClaim"}],
"saml2Token": [{"@odata.type": "microsoft.graph.optionalClaim"}]
}