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

# Create an organization

`POST /v1/org`

## Request

- Base URL: `https://api.chainmemory.ai`
- URL: `https://api.chainmemory.ai/v1/org`
- Auth: API key in header `x-api-key`

Authenticated with your personal key. One key can own one organization. It starts `suspended`: reads work, issuing keys and inviting return 402 until it is activated.

## Request body

- object
  - `org_slug` string, required: 3-40 chars: lowercase, digits and hyphens; cannot start or end with a hyphen
  - `name` string, required
  - `owner_email` string, required: Becomes the first member, role owner
  - `tier` string: team or enterprise

## Response `200`

Created

## Other responses

- `400`: Invalid slug or missing field
- `409`: This key already owns an organization

---

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