---
title: "Create Organization"
method: POST
path: "/api/platform/organizations"
tags: ["platform"]
---

# Create Organization

`POST /api/platform/organizations`

Create an organization in the connected Auth0 tenant.

Requires ``editor`` on the ``members-organizations`` module instance (derived from the
POST method by the parent router gate). The organization is created
natively in Auth0 (the source of truth). The tenant's default
username/password connection (``AUTH0_DEFAULT_DB_CONNECTION``) is enabled
on the new org so members can sign in (best-effort — org creation still
succeeds if connection wiring fails). Because a brand-new Auth0
organization has no members — and organizations exist in FGA only through
``member`` tuples — the creating operator is added as its first member in
both Auth0 and FGA so the new org is immediately reflected in the
authorization store and survives the next ``sync-members`` reconciliation.

## Request body

- CreateOrganizationRequest — Operator-supplied payload for creating an Auth0 organization. Only ``name`` is required: it is the organization's unique slug (the value Auth0 stores as ``name`` and uses in invitation/login URLs), so it is constrained to lowercase letters, digits, hyphens, and underscores. ``displayName`` is the human-friendly label shown in the UI; when omitted Auth0 falls back to the slug. Auth0 remains the source of truth — it rejects duplicate or otherwise-invalid names with a 409/400 the service surfaces back to the operator.
  - `name` string, required
  - `displayName` string, nullable

## Response `201`

Successful Response

- Organization — A single organization in the connected Auth0 tenant.
  - `id` string, required
  - `name` string, required
  - `displayName` string, nullable
  - `brandingLogoUrl` string, nullable
  - `brandingColorsPrimary` string, nullable
  - `memberCount` integer
  - `groups` OrganizationGroup[]
    - `id` string, required
    - `displayName` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)