---
title: "Create an organization, optionally with its first org_admin (two-step)"
method: POST
path: "/api/admin/orgs"
tags: ["admin"]
---

# Create an organization, optionally with its first org_admin (two-step)

`POST /api/admin/orgs`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/admin/orgs`
- Auth: none declared

## Request body

- AdminCreateOrgBody
  - `name` string, required
  - `lang` 'he' | 'en' | 'pt'
  - `ownerEmail` string, email
  - `ownerPhone` string
  - `reason` string: Why (required to apply a write and to read content; recorded in the audit / staff access log).
  - `confirm` boolean: false = return a preview only; true = apply the change.

## Response `200`

Preview or result.

- union
  - object
    - `preview` object, required
  - object
    - `applied` object, required

## Other responses

- `400`: Invalid request or reason missing.
- `403`: Not a super_admin.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)