---
title: "Create an organization"
method: POST
path: "/api/v4/organizations"
tags: ["organizations"]
---

# Create an organization

`POST /api/v4/organizations`

## Request

- Base URL: `https://gitlab.com`
- URL: `https://gitlab.com/api/v4/organizations`
- Auth: none declared

Creates an organization. This feature was introduced in GitLab 17.5. This feature is behind the `allow_organization_creation` feature flag. In GitLab 18.3, the feature flag changed to `organization_switching`.

## Request body

- PostApiV4Organizations: Create an organization
  - `name` string, required: The name of the organization
  - `path` string, required: The path of the organization
  - `description` string: The description of the organization
  - `visibility` 'private' | 'public': The visibility level of the organization
  - `avatar` string, binary: The avatar image for the organization

## Response `201`

Create an organization

- APIEntitiesOrganizationsOrganization: API_Entities_Organizations_Organization model
  - `id` integer, required
  - `uuid` string, required
  - `name` string, required
  - `path` string, required
  - `description` string, required
  - `visibility` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `web_url` string, required
  - `avatar_url` string, required

---

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