---
title: "Create an organization"
method: POST
path: "/orgs"
tags: ["organization"]
---

# Create an organization

`POST /orgs`

## Request body

- CreateOrgOption — CreateOrgOption options for creating an organization
  - `description` string — The description of the organization
  - `email` string — The email address of the organization
  - `full_name` string — The full display name of the organization
  - `location` string — The location of the organization
  - `repo_admin_change_team_access` boolean — Whether repository administrators can change team access
  - `username` string, required — username of the organization
  - `visibility` 'public' | 'limited' | 'private' — possible values are `public` (default), `limited` or `private`
  - `website` string — The website URL of the organization

## Response `201`

Organization

- Organization — Organization represents an organization
  - `avatar_url` string — The URL of the organization's avatar
  - `description` string — The description of the organization
  - `email` string — The email address of the organization
  - `full_name` string — The full display name of the organization
  - `id` integer — The unique identifier of the organization
  - `location` string — The location of the organization
  - `name` string — The name of the organization
  - `repo_admin_change_team_access` boolean — Whether repository administrators can change team access
  - `username` string — username of the organization deprecated
  - `visibility` 'public' | 'limited' | 'private' — The visibility level of the organization (public, limited, private)
  - `website` string — The website URL of the organization

## Other responses

- `403` — APIForbiddenError is a forbidden error response
- `422` — APIValidationError is error format response related to input validation

---

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