---
title: "Create an organization"
method: POST
path: "/v1/organizations/"
tags: ["organizations"]
---

# Create an organization

`POST /v1/organizations/`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/organizations/`
- Auth: none declared

Create an organization on behalf of an integrator's partner.

Restricted to integrators; the caller's own ``is_integrator``
partner becomes the owning partner of the new organization. Seeds
an ``INTEGRATOR_ORG`` subscription from the ``"integrated"``
catalog plan, capped by the partner's own asset limit.

Args:
    body (CreateOrganizationRequest): Organization creation payload.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.
    partner_id (int): The caller's own integrator partner id.

Returns:
    SuccessResponse: The legacy create envelope carrying the new id.

## Request body

- CreateOrganizationRequest: Request body for organization creation (integrator flow). Matches the legacy ``api`` app's ``CreateOrganization`` model exactly — no ``billing_email``/``payment_token``: those belong to the unrelated self-service signup flow, not integrator-initiated creation. Attributes: name (str): Organization name. assets_limit (int | None): Requested asset cap; falls back to a default when omitted, capped by the integrator's own partner subscription limit.
  - `name` string, required: Organization name
  - `assets_limit` integer, nullable: Requested asset cap for the new organization

## Response `201`

Successful Response

- SuccessResponse: Standard response for successful write operations. Matches the ``SuccessResponse`` contract from api-3. Attributes: code (int): HTTP status code. description (str): Human-readable result description. id (int | str | None): Created/affected resource ID. success (bool): Always ``True`` for successful responses.
  - `code` integer, required
  - `description` string, required
  - `id` union
    - integer
    - string
  - `success` boolean

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ethiack/apis/ethiack-api.md) - [All operations](https://skmtc.dev/ethiack/apis/ethiack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ethiack/apis/ethiack-api/revisions/4eaba89bfebf?raw)