---
title: Identity Provider Attributes
description: Explains how to map external identity provider user attributes to PingOne user attributes using placeholder syntax, including JSON dot-notation attribute names
component: pingone-api
page_id: pingone-api:platform:identity-provider-management/identity-provider-attributes/index
canonical_url: https://developer.pingidentity.com/pingone-api/platform/identity-provider-management/identity-provider-attributes/index.html
llms_txt: https://developer.pingidentity.com/pingone-api/llms.txt
docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md
revdate: 2026-08-11
---

# Identity Provider Attributes

When defining an external identity provider resource, user attributes from the external identity provider are mapped to PingOne user attributes. The mapping attribute placeholder value must be expressed using the following syntax in the request body:

`${providerAttributes.<IdP attribute name>}`

For example, the request body for the Facebook-to-PingOne email-to-email mapping looks like this, with the `value` attribute showing the Facebook `email` attribute expressed using the placeholder syntax:

```json
{
    "name": "email",
    "update": "EMPTY_ONLY",
    "value": "${providerAttributes.email}"
}
```

|   |                                                                                                                                                                                                                                                                                                                                                                                                   |
| - | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | For external identity providers that pass in attributes in JSON structure (all external providers except SAML), the syntax for mapping attributes that use JSON dot notation, such as `name.family`, must use square brackets and single quotes around the attribute name:```json
{
    "name": "lastName",
    "update": "EMPTY_ONLY",
    "value": "${providerAttributes['name.family']}"
}
``` |