SCIM customization

concept brazil Updated Sep 10, 2026 1 min read scim-customisation.md

SCIM customization enables you to customize SCIM protocols for your identity management.

SCIM customization enables you to do the following:

Support custom fields on the sys_user and sys_user_group tables through dynamic extension schema generation.
Override the default SCIM mappings.

You need the scim_config_admin role to define custom extension schemas for user and group resources. The attributes defined in the custom extension schema can be mapped to fields in the sys_user and sys_user_group tables.

Configurations for SCIM customization

For SCIM customization, you should perform the following tasks:

Define a custom extension schema for users and groups in the SCIM Extension schema table.  For more information, see Create a SCIM extension schema.
Create entities in an ETL definition for custom schema attributes. The entities are created for the target table that is mapped with either the sys_user and sys_user_group attributes. For more information, see Create a SCIM ETL definition.
Create an RTE mapping between these two entities.  For more information, see step 5 in the Create a SCIM ETL definition.
Send custom schema attributes with data in the SCIM API request payload.

The SCIM API calls the RTE engine with the defined mapping. The data is stored in the respective fields in the target table as defined in the mapping.

37 lines · 2.4 KB Wrap lines

---
title: SCIM customization
description: SCIM customization enables you to customize SCIM protocols for your identity management.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/platform-security/identity/scim-customisation.html
release: brazil
product: Identity
classification: identity
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [SCIM Provider, System for Cross-domain Identity Management \(SCIM\), Identity]
---

# SCIM customization

SCIM customization enables you to customize SCIM protocols for your identity management.

SCIM customization enables you to do the following:

- Support custom fields on the `sys_user` and `sys_user_group` tables through dynamic extension schema generation.
- Override the default SCIM mappings.

You need the `scim_config_admin` role to define custom extension schemas for user and group resources. The attributes defined in the custom extension schema can be mapped to fields in the `sys_user` and `sys_user_group` tables.

## Configurations for SCIM customization

For SCIM customization, you should perform the following tasks:

- Define a custom extension schema for users and groups in the SCIM Extension schema table. For more information, see [Create a SCIM extension schema](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-security/identity/create-scim-extension-schemas.md).
- Create entities in an ETL definition for custom schema attributes. The entities are created for the target table that is mapped with either the `sys_user` and `sys_user_group` attributes. For more information, see [Create a SCIM ETL definition](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-security/identity/create-scim-etl-definitions.md).
- Create an RTE mapping between these two entities. For more information, see step [5](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-security/identity/create-scim-etl-definitions.md) in the [Create a SCIM ETL definition](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/platform-security/identity/create-scim-etl-definitions.md).
- Send custom schema attributes with data in the SCIM API request payload.

The SCIM API calls the RTE engine with the defined mapping. The data is stored in the respective fields in the target table as defined in the mapping.