Create a SCIM extension schema

task australia Updated Sep 10, 2026 1 min read create-scim-extension-schemas.md

Create custom attributes to map to fields that are not mapped as part of either the core schema or the ServiceNow extension schema.

Before you begin

Role required: scim_config_admin

Warning: Grant this role carefully. The scim_config_admin role is equivalent to giving the user the admin role, where the scim_config_admin role can insert new records into the tables that can bypass business logic or ACL protection.

Procedure

Navigate to All > SCIM > SCIM Extension schemas.
Select New.
On the form, fill in the fields.

Note: Only one extension schema can be mapped to the Resource Type field. For example, User as a resource type can be mapped to a user extension schema.

Field	Description
Name	Name of the extension schema.
Active	Option to activate the schema. Select this field if the record must be considered as custom extension schema. Only one custom extension schema record can be active at a time for a specific resource type, whether for the User or Group type.
Resource Type	Resource type that has to be mapped to the extension schema. The following are the options:- User Group
Application	Application scope for this record.
Schema JSON	Details within the JSON schemas. For more information about defining the extension schema with attributes, see Datatracker.

\[Omitted image "scim-extension-schemas.png"\] Alt text: SCIM Extension schema

Validate the attributes by selecting Validate.
Select Submit.

Result

The extension schema with custom attributes related to User or Group resource type is created. Use the SCIM ETL Definitions to map the resources based on the extension schema on the sys_user and sys_user_group table. For more information, see Create a SCIM ETL definition.

97 lines · 2.8 KB Wrap lines

---
title: Create a SCIM extension schema
description: Create custom attributes to map to fields that are not mapped as part of either the core schema or the ServiceNow extension schema.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/platform-security/identity/create-scim-extension-schemas.html
release: australia
product: Identity
classification: identity
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [SCIM customization, SCIM Provider, System for Cross-domain Identity Management \(SCIM\), Identity]
---

# Create a SCIM extension schema

Create custom attributes to map to fields that are not mapped as part of either the core schema or the ServiceNow extension schema.

## Before you begin

Role required: scim\_config\_admin

**Warning:** Grant this role carefully. The scim\_config\_admin role is equivalent to giving the user the admin role, where the scim\_config\_admin role can insert new records into the tables that can bypass business logic or ACL protection.

## Procedure

1.  Navigate to **All** &gt; **SCIM** &gt; **SCIM Extension schemas**.

2.  Select **New**.

3.  On the form, fill in the fields.

    **Note:** Only one extension schema can be mapped to the **Resource Type** field. For example, User as a resource type can be mapped to a user extension schema.

<table id="table_z3g_llg_btb"><thead><tr><th>

Field

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Name

</td><td>

Name of the extension schema.

</td></tr><tr><td>

Active

</td><td>

Option to activate the schema. Select this field if the record must be considered as custom extension schema. Only one custom extension schema record can be active at a time for a specific resource type, whether for the User or Group type.

</td></tr><tr><td>

Resource Type

</td><td>

Resource type that has to be mapped to the extension schema. The following are the options:-   **User**
-   **Group**


</td></tr><tr><td>

Application

</td><td>

Application scope for this record.

</td></tr><tr><td>

Schema JSON

</td><td>

Details within the JSON schemas. For more information about defining the extension schema with attributes, see [Datatracker](https://datatracker.ietf.org/doc/html/rfc7643#section-7).

</td></tr></tbody>
</table>    \[Omitted image "scim-extension-schemas.png"\] Alt text: SCIM Extension schema

4.  Validate the attributes by selecting **Validate**.

5.  Select **Submit**.


## Result

The extension schema with custom attributes related to User or Group resource type is created. Use the SCIM ETL Definitions to map the resources based on the extension schema on the sys\_user and sys\_user\_group table. For more information, see [Create a SCIM ETL definition](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-security/identity/create-scim-etl-definitions.md).