v13

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-04237161688.6 KB

SCIM Directories

Create a SCIM group role mapping

Creates a new SCIM group to organization role mapping for a SCIM directory. Group role mapping must be enabled on the directory.

post/scim_directories/{scim_directory_id}/group_role_mappings

Path parameters

scim_directory_idstring required

The ID of the SCIM directory.

Request body

scim_group_idstring required

The SCIM group ID from the identity provider.

role_idstring required

The ID of the organization role to assign to members of the SCIM group.

precedenceinteger

The precedence for this mapping. Lower values take priority when a user belongs to multiple mapped groups. If omitted, the mapping is appended with the next-highest precedence.

Response

A SCIM group role mapping

object'scim_group_role_mapping' required

String representing the object's type. Always "scim_group_role_mapping".

idstring required

Unique identifier for the SCIM group role mapping.

scim_directory_idstring required

The ID of the SCIM directory this mapping belongs to.

scim_group_idstring required

The SCIM group ID from the identity provider.

scim_group_display_namestring required

The display name of the SCIM group, as reported by the identity provider.

precedenceinteger required

Mapping precedence, starting at 1. Lower values take priority when a user belongs to multiple mapped groups.

created_atinteger required

Unix timestamp (milliseconds) of when the mapping was created.

updated_atinteger required

Unix timestamp (milliseconds) of when the mapping was last updated.