---
title: "Create Organization"
method: POST
path: "/v1/orgs"
tags: ["Organizations"]
---

# Create Organization

`POST /v1/orgs`

## Request

- Base URL: `https://api.fettle.sh` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fettle.sh/v1/orgs`
- Auth: API key in header `Authorization`

Create a new organization. You become its owner.

## Request body

- CreateOrganizationRequest: Request body for creating an organization.
  - `name` string, required

## Response `201`

Successful Response

- OrganizationRead: Public view of an organization. ``plan`` is here so the dashboard can badge every membership in the org switcher without a per-org subscription call. It is the tier and nothing else — billing identifiers and subscription state stay on ``GET /v1/users/me/subscription``.
  - `id` string, uuid, required
  - `name` string, required
  - `timezone` string, required
  - `plan` 'FREE' | 'PLUS' | 'PRO' | 'MAX' | 'ENTERPRISE', required: Subscription tier of an organization; gates feature/usage limits.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fettle/apis/fettle-sh.md) · [All operations](https://skmtc.dev/fettle/apis/fettle-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/fettle/apis/fettle-sh/revisions/f32c8a18606f?raw)