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

# Create an organization

`POST /api/v1/organizations`

## Request

- Base URL: `https://api.mencoro.com`
- URL: `https://api.mencoro.com/api/v1/organizations`
- Auth: HTTP bearer

Requires a key scoped to all organizations and the "organization:manage" capability: a key limited to named organizations cannot widen its own reach by creating one. Preview it first and send the confirmation in X-Mencoro-Confirmation together with an Idempotency-Key.

## Headers

- `X-Mencoro-Confirmation` string, required
- `Idempotency-Key` string, required

## Request body

- object
  - `name` string

## Response `201`

Organization created. Your owner membership follows asynchronously, so a read immediately afterwards can answer 404 until it lands.

- object
  - `id` string, uuid
  - `name` string
  - `status` string: Always active on creation.

## Other responses

- `401`: Missing or invalid API key
- `403`: The key is not scoped to all organizations, or lacks "organization:manage"
- `409`: The confirmation is invalid, expired, already used, or its effects changed
- `428`: No confirmation was sent; preview the operation first

---

[API](https://skmtc.dev/mencoro/apis/mencoro-api.md) · [All operations](https://skmtc.dev/mencoro/apis/mencoro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mencoro/apis/mencoro-api/revisions/022b6e82faa4?raw)