---
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

> 24 revisions in range; 9 could not be searched.

- **2023-06-14** `1057260fde29` — 2 info
  - api tag `Organization` added
  - api tag `Organizations` removed
- **2023-05-24** `11f0e17a96b4` — 1 info
  - endpoint added

[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/836ecb425096/schema)