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

# Create organization

`POST /v1/organizations`

Create a new organization.

## Request body

- object
  - `slug` string, required — Globally unique canonical kebab-case slug. Reserved values are join and new. Must not parse as an xid.
  - `name` string, required — Name of the organization.
  - `email` string, email, required — Email address of the organization.
  - `logo` string, uri — Logo of the organization.
  - `website` string, uri — Work title of the user.

## Response `201`

Example response

- object
  - `id` string, required — ID of the newly created resource.

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `403` — Forbidden
- `409` — Conflict
- `500` — Internal Server Error

## Changes

- **2026-08-26** `836ecb425096` — 1 breaking, 1 info
  - added the new required request property `slug`
  - added the non-success response with the status `409`
- **2023-06-14** `1057260fde29` — 2 info
  - api tag `Organization` added
  - api tag `Organizations` removed
- **2023-05-24** `11f0e17a96b4` — 1 info
  - endpoint added
- **2023-03-18** `f157ff402bc1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/opcotech/apis/elemo-api/changes/v1/organizations/post.md)

---

[API](https://skmtc.dev/opcotech/apis/elemo-api.md) · [All operations](https://skmtc.dev/opcotech/apis/elemo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opcotech/elemo-api/revisions/605ffe113d3d/schema)