Sign in
organizations

Create a child organization

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

post/v1/organizations/{organizationId}/children

Path parameters

organizationIdstring required

Parent organization ID

Headers

X-API-Keystring

API key

Request body

namestring required

Child organization name

slugstring

Organization slug (URL-safe identifier)

domainsstring[]

Allowed email domains

allowProfilesOutsideOrganizationboolean

Allow profiles outside organization

Response

Child organization created

idstring required

Organization ID

workosOrganizationIdstring required

WorkOS Organization ID

slugstring required

Organization slug

namestring required

Organization name

logoUrlstring nullable required

Organization logo URL

domainsstring[] required

Organization domains

statusstring required

Organization status

allowProfilesOutsideOrganizationboolean required

Allow profiles outside organization

enableMinimalRequirementsboolean required

Whether reduced individual verification requirements are enabled

bankPartnerRoutesEnabledboolean required

Whether banking-partner route capabilities are enabled

customerIdstring nullable required

Customer ID for the organization

slackChannelIdstring nullable

Slack channel ID bound to this organization

slackOpsChannelIdstring nullable

Slack channel ID for ops/compliance notifications. Falls back to slackChannelId when not set.

complianceEmailstring nullable

Email address for compliance communications

metadataobject required

Organization metadata

createdAtstring date-time required

Organization creation date

updatedAtstring date-time required

Organization last update date

Example response

{
  "createdAt": "2026-01-15T10:00:00Z",
  "updatedAt": "2026-01-15T10:00:00Z"
}

Changes