---
title: "Create new organization"
method: POST
path: "/organizations"
tags: ["organizations", "users"]
---

# Create new organization

`POST /organizations`

Creates a Chronograf organization in the store

## Request body

- Organization — A group of Chronograf users with various role-based access-control.
  - `defaultRole` 'member' | 'viewer' | 'editor' | 'admin' — The default role that new users in this organization will have.
  - `id` string — Unique identifier representing an organization resource. The Default organization will have the id 'default', and any further will start at '1' and increment.
  - `links` object
    - `self` string, url — Self link mapping to this resource
  - `name` string, required — User-facing name of the organization resource.

## Response `201`

Organization successfully created

- Organization — A group of Chronograf users with various role-based access-control.
  - `defaultRole` 'member' | 'viewer' | 'editor' | 'admin' — The default role that new users in this organization will have.
  - `id` string — Unique identifier representing an organization resource. The Default organization will have the id 'default', and any further will start at '1' and increment.
  - `links` object
    - `self` string, url — Self link mapping to this resource
  - `name` string, required — User-facing name of the organization resource.

## Other responses

- `400` — Invalid JSON – unable to encode or decode; or failed to perform operation in data store
- `403` — Forbidden to access this route
- `422` — Invalid data schema provided to server for organization
- `default` — Internal server error

---

[API](https://skmtc.net/influxdata/apis/chronograf.md) · [All operations](https://skmtc.net/influxdata/apis/chronograf/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/influxdata/chronograf/revisions/ce55d963b4ac/schema)