Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

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 > SCIM > SCIM Extension schemas.

  2. Click 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.

FieldDescription
NameName of the extension schema.
ActiveOption 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 TypeResource type that has to be mapped to the extension schema. The following are the options:- User - Group
ApplicationApplication scope for this record.
Schema JSONDetails within the JSON schemas. For more information about defining the extension schema with attributes, see Datatracker.
Image omitted: scim-extension-schemas.png
SCIM Extension schema
  1. Validate the attributes by clicking Validate.

  2. Click 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.