---
title: "Create a child organization"
method: POST
path: "/v1/organizations/{organizationId}/children"
tags: ["organizations"]
---

# Create a child organization

`POST /v1/organizations/{organizationId}/children`

Creates a one-level child under a top-level parent. Requires the child-organizations feature flag. Does not add the creator as a member.

## Path parameters

- `organizationId` string, required

## Headers

- `X-API-Key` string

## Request body

- CreateChildOrganizationDto
  - `name` string, required — Child organization name
  - `slug` string — Organization slug (URL-safe identifier)
  - `domains` string[] — Allowed email domains
  - `allowProfilesOutsideOrganization` boolean — Allow profiles outside organization

## Response `201`

Child organization created

- OrganizationResponseDto
  - `id` string, required — Organization ID
  - `workosOrganizationId` string, required — WorkOS Organization ID
  - `slug` string, required — Organization slug
  - `name` string, required — Organization name
  - `logoUrl` string, nullable, required — Organization logo URL
  - `domains` string[], required — Organization domains
  - `status` string, required — Organization status
  - `allowProfilesOutsideOrganization` boolean, required — Allow profiles outside organization
  - `enableMinimalRequirements` boolean, required — Whether reduced individual verification requirements are enabled
  - `bankPartnerRoutesEnabled` boolean, required — Whether banking-partner route capabilities are enabled
  - `customerId` string, nullable, required — Customer ID for the organization
  - `slackChannelId` string, nullable — Slack channel ID bound to this organization
  - `slackOpsChannelId` string, nullable — Slack channel ID for ops/compliance notifications. Falls back to slackChannelId when not set.
  - `complianceEmail` string, nullable — Email address for compliance communications
  - `metadata` object, required — Organization metadata
  - `createdAt` string, date-time, required — Organization creation date
  - `updatedAt` string, date-time, required — Organization last update date

## Other responses

- `401` — Unauthorized - Invalid or missing authentication credentials

---

[API](https://skmtc.dev/infinite/apis/infinite-api.md) · [All operations](https://skmtc.dev/infinite/apis/infinite-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infinite/apis/infinite-api/revisions/0b0a3231b482?raw)