SCIM Directories

Create a directory

Changed on

Create a new directory for the instance.

post/scim_directories

Request

  • Base URL: https://api.clerk.com/v1
  • URL: https://api.clerk.com/v1/scim_directories
  • Auth: HTTP bearer

Request body

enterprise_connection_idstring required

The ID of the enterprise connection to associate with this directory.

namestring

A human-friendly name for the directory.

providerstring required

The identity provider for this directory.

Response

A directory

object'scim_directory' required

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

idstring required

Unique identifier for the directory.

namestring required

A human-friendly name for the directory.

enterprise_connection_idstring nullable

The ID of the associated enterprise connection.

endpoint_urlstring required

The SCIM endpoint URL for this directory.

providerstring required

The identity provider for this directory.

enabledboolean required

Whether the directory is enabled.

pausedboolean required

Whether syncing is paused. A paused directory rejects SCIM requests and skips scheduled syncs, but keeps the organization memberships it granted. Disabling a directory removes them instead.

group_role_mapping_enabledboolean required

Whether group-to-role mapping is enabled for this directory.

attribute_mappingobject required

Mapping of user attributes to the SCIM attribute paths they are extracted from.

api_keystring nullable

The API key for authenticating SCIM requests. Only returned when the directory is created or the key is rotated.

created_atinteger required

Unix timestamp when the directory was created.

updated_atinteger required

Unix timestamp when the directory was last updated.

Changes

  • 2025-11-10a490313abffaRevision changes
    • info

      added the required property to the response with the status

  • 2025-11-10f0ead9fddcd6Revision changes
    • info

      added the optional property // to the response with the status