--- title: Specifying custom SCIM attributes description: You can configure simple, multivalued, and complex custom System for Cross-domain Identity Management (SCIM) attributes in PingFederate. component: pingfederate version: 13.1 page_id: pingfederate:administrators_reference_guide:pf_specifying_custom_scim_attributes canonical_url: https://docs.pingidentity.com/pingfederate/13.1/administrators_reference_guide/pf_specifying_custom_scim_attributes.html llms_txt: https://docs.pingidentity.com/pingfederate/llms.txt docs_for_agents: https://developer.pingidentity.com/build-with-ai/docs-for-agents.md revdate: December 1, 2025 section_ids: about-this-task: About this task steps: Steps --- # Specifying custom SCIM attributes You can configure simple, multivalued, and complex custom System for Cross-domain Identity Management (SCIM) *(tooltip: \
\

An application-level, HTTP-based protocol for provisioning and managing user identity information. SCIM supplies a common schema for representing users and groups and provides a REST API.\

\
)* attributes in PingFederate. ### About this task PingFederate supports SCIM attributes in the core schema and custom attributes through a schema extension. | | | | - | ------------------------------------------------------------------------------------------------------------------------------------------------- | | | Custom attributes are optional. If your use case doesn't require any additional attributes, click **Next** on the **Custom SCIM Attributes** tab. | To support custom attributes, you must specify the schema extension and the custom attributes in the connection. There are four attribute types: * Simple attributes * Simple multivalued attributes * Complex attributes * Complex multivalued attributes The following fragment illustrates a SCIM message supporting schema extension `urn:scim:schemas:extension:custom:1.0` with four attributes, one of each attribute type. The table afterward describes the details of each attribute. ```json { "userName":"CBrown", "active":true, "schemas":[ "urn:scim:schemas:core:1.0", "urn:scim:schemas:extension:custom:1.0" ], ... "urn:scim:schemas:extension:custom:1.0":{ "supervisor":"JSmith", "territories":[ "Montana", "Idaho", "Wyoming" ], "options":{ "quantity":"10000", "strike" :"5.25", "first" :"2017-12-01", "last" :"2025-03-31" }, "tablets":[ { "model" :"8086", "serial":"5500-2020-965", "type" :"office" }, { "model" :"8088", "serial":"5500-2040-151", "type" :"remote" } ] } } ``` | Attribute Name | Attribute Type | Sub-Attributes (Complex) | | -------------- | ------------------- | ------------------------------------------------------------------------------------------------------------- | | `supervisor` | Simple | Not applicable | | `territories` | Simple multivalued | Not applicable | | `options` | Complex | `quantity`, `strike`, `first`, and `last` | | `tablets` | Complex multivalued | `model`, `serial`, and `type`. type is a reserved sub-attribute for a complex multivalued attribute. | | | | | - | --------------------------------------------------------------------------------------------------------------------------------------- | | | Learn more about SCIM and attribute types in the [SCIM 1.1 Core Schema](https://simplecloud.info/specs/draft-scim-core-schema-01.html). | ## Steps 1. Go to **Applications > Integration > SP Connection > Configure Channels**. Specify the URI of the schema extension in the **Extension Namespace** field. ![Screen capture illustrating the Custom SCIM Attributes tab.](_images/lry1564003435562.jpg) | | | | - | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | The default value is `urn:scim:schemas:extension:custom:1.0`. You can keep this value if your partner identifies custom attributes by this URI in its SCIM messages. | 2. Enter an attribute name and click **Add** to add a custom attribute. Repeat this step to add more custom attributes as needed. | | | | - | ------------------------------------------------------------------------------------------------------------------- | | | Use the **Delete** and **Undelete** workflow to remove or cancel the removal request of existing custom attributes. | 3. Click **Edit** next to the custom attribute to perform one of the following tasks. | | | | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Change the attribute name | 1. Replace the current value in the **Name** field. 2. Click **Done**. | | Set the attribute as a simple multivalued attribute | 1) Select the **Is Multivalued** checkbox. 2) Click **Done**. ![Screen capture illustrating a multivalued attribute on the Custom SCIM Attribute Options tab.](_images/oqy1564003437471.jpg) | | Add sub-attributes to make the attribute a complex attribute | 1. Enter a sub-attribute and click **Add**. Repeat this step to add more sub-attributes as needed. 2. Use the **Edit**, **Update**, and **Cancel** workflow to make or undo a change to the name of a sub-attribute. Use the **Delete** and **Undelete** workflow to remove a sub-attribute or cancel the removal request. 3. Click **Done**. ![Screen capture illustrating a complex attribute on the Custom SCIM Attribute Options tab.](_images/uws1564003438210.jpg) | | Add sub-attributes and set the attribute as a complex multivalued attribute | 1) Enter a sub-attribute and click **Add**. Repeat this step to add more sub-attributes as needed. Use the Edit, Update, and Cancel workflow to make or undo a change to the name of a sub-attribute. Use the Delete and Undelete workflow to remove a sub-attribute or cancel the removal request. 2) Select the **Is Multivalued** checkbox. 3) Specify at least one value under the **Types** column for `type`, a reserved sub-attribute for a complex multivalued attribute. Use the Edit, Update, and Cancel workflow to make or undo a change to the type value. Use the Delete and Undelete workflow to remove a type value or cancel the removal request. 4) Click **Done**. ![Screen capture illustrating a complex multivalued attribute on the Custom SCIM Attribute Options tab.](_images/keo1564003438984.jpg) |