---
title: "Create a team organization owned by the caller, with its default project and a wallet ready to fund"
method: POST
path: "/v1/organizations"
tags: ["Organizations"]
---

# Create a team organization owned by the caller, with its default project and a wallet ready to fund

`POST /v1/organizations`

## Request

- Base URL: `https://console-api-sandbox.akash.network`
- URL: `https://console-api-sandbox.akash.network/v1/organizations`
- Auth: HTTP bearer

## Headers

- `x-organization-id` string
- `x-project-id` string, uuid

## Request body

- object
  - `data` object, required
    - `name` string, required: Creating or renaming is refused when the caller already belongs to another organization of this name, ignoring case. Organizations joined by invitation may share a name.

## Response `201`

The created organization

- object
  - `data` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string, required
    - `type` 'personal' | 'team', required
    - `role` 'owner' | 'admin' | 'member' | 'billing' | 'viewer', required: The caller's role in the organization.
    - `isActive` boolean, required: Whether this request ran in this organization.
    - `hasPaymentMethod` boolean, nullable, required: Whether the organization has a payment method saved, its owner's own cards for a personal organization. Null for an organization this request did not run in.
    - `createdAt` string, date-time, required

## Other responses

- `400`: The name is empty, too long or holds a control character
- `401`: Unauthorized
- `403`: The caller has reached their organization limit (`organization_limit_reached`), or the request was not made from a signed-in session (`session_required`)
- `409`: The caller already belongs to an organization with this name (`organization_name_taken`)

## Changes

- **2026-10-25** `045ec4086a98`: 1 warning
  - changed the pattern of the request property `data/name` from `^[^\p{Cc}\p{Bidi_Control}]+$` to `^[^\u0000-\u001f\u007f-\u009f\u061c\u200e\u200f\u202a-\u202e\u2066-\u2069]*$`
- **2026-10-16** `98286e0476c7`: 1 info
  - added the required property `data/hasPaymentMethod` to the response with the `201` status
- **2026-10-15** `bb97e5bacb6f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/organizations/post.md)

---

[API](https://skmtc.dev/akash-network/apis/akash-network-console-api.md) - [All operations](https://skmtc.dev/akash-network/apis/akash-network-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akash-network/apis/akash-network-console-api/revisions/b959efa6d493?raw)