---
title: "Create"
method: POST
path: "/api/v1/local-directory-configs"
tags: ["Local Directory"]
---

# Create

`POST /api/v1/local-directory-configs`

Create a new local directory config backed by an existing App.

## Request body

- C1ApiLocalDirectoryV1LocalDirectoryConfigServiceCreateRequest — The LocalDirectoryConfigServiceCreateRequest message.
  - `allowSelfRegistration` boolean — The allowSelfRegistration field.
  - `appId` string, required — FK to the existing App that will back this local directory.
  - `defaultProfileTypeId` string — The defaultProfileTypeId field.
  - `displayName` string, required — The displayName field.
  - `invitationTtl` string, duration, nullable
  - `isDefault` boolean — Whether this should be the default local directory for the tenant.
  - `onboardingFlowId` string — The onboardingFlowId field.
  - `organizationId` string — Optional FK to a ThirdPartyOrganization.
  - `selfRegistrationDomains` string[], nullable — The selfRegistrationDomains field.

## Response `200`

Successful response

- C1ApiLocalDirectoryV1LocalDirectoryConfigServiceCreateResponse — The LocalDirectoryConfigServiceCreateResponse message.
  - `localDirectoryConfig` C1ApiLocalDirectoryV1LocalDirectoryConfig — LocalDirectoryConfig is the public representation of a C1-managed local directory configuration. The underlying directory infrastructure is provided by the linked App (identified by app_id).
    - `allowSelfRegistration` boolean — Whether unauthenticated users may self-register in this directory.
    - `appId` string — app_id is the identifier for this config and its linked App. Read-only after creation.
    - `createdAt` string, date-time, nullable
    - `defaultProfileTypeId` string — Optional FK to a ProfileType applied to new users created via this directory.
    - `displayName` string — The displayName field.
    - `invitationTtl` string, duration, nullable
    - `isDefault` boolean — Whether this is the default local directory for the tenant. At most one config per tenant may be the default.
    - `onboardingFlowId` string — Optional FK to an onboarding flow applied by default when inviting users.
    - `organizationId` string — Optional FK to a ThirdPartyOrganization. Empty means standalone (no vendor linkage).
    - `selfRegistrationDomains` string[], nullable — Email domain allowlist for self-registration. Empty allows any domain when allow_self_registration is true.
    - `updatedAt` string, date-time, nullable

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)