---
title: "Create an organization; the caller becomes its org_admin (self sign-up — off by default: super admins only)"
method: POST
path: "/api/orgs"
tags: ["orgs"]
---

# Create an organization; the caller becomes its org_admin (self sign-up — off by default: super admins only)

`POST /api/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/orgs`
- Auth: none declared

## Request body

- CreateOrgBody
  - `name` string, required
  - `lang` 'he' | 'en' | 'pt'

## Response `201`

Created.

- object
  - `id` string, required
  - `slug` string, required
  - `name` string, required
  - `tier` 'standard' | 'dedicated' | 'byoc'
  - `status` 'active' | 'suspended' | 'archived'
  - `kind` 'customer' | 'internal' | 'demo' | 'system' | 'test' | 'personal'
  - `lang` 'he' | 'en' | 'pt'
  - `region` 'europe-west1'
  - `branding` object
    - `brand` string
    - `logoUrl` string, uri
  - `data` object
    - `projectId` string
    - `datasetId` string
    - `runtimeIdentity` string
    - `filesBucket` string
    - `stagingBucket` string
  - `plan` object
    - `id` string, required
    - `quotas` object
  - `retention` object
    - `conversationDays` integer
  - `timezone` string
  - `greetingExamples` string[]
  - `createdAt` string, date-time, required
  - `createdBy` string
  - `updatedAt` string, date-time
  - `updatedBy` string
  - `schemaVersion` integer
  - `emailDomains` string[]
  - `security` object
    - `mfa` 'admins' | 'all'
    - `mfaTrustIdp` boolean
    - `signIn` object
      - `methods` string[]
      - `open` boolean
      - `byRole` object
        - `admin` object
          - `methods` string[]
          - `mfa` object
            - `required` boolean
        - `member` object
          - `methods` string[]
          - `mfa` object
            - `required` boolean
    - `externalAgentWrite` boolean
    - `lockedBy` 'platform'
  - `aiDisclosure` object
    - `enabled` boolean
    - `text` object
      - `he` string
      - `en` string
      - `pt` string
    - `notifyExisting` boolean

## Other responses

- `401`: Unauthenticated.
- `403`: Self sign-up is off: a super admin opens organizations.

## Changes

- **2026-10-20** `5a47416c82ec`: 1 info
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/wizbi/apis/wizbi-core-api/changes/api/orgs/post.md)

---

[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)