Skip to content
forgit api docs

Create an organization

POST
/admin/users/{username}/orgs

Authorizations

Section titled “ Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “ Path Parameters ”
username
required
string

Username of the user that will own the created organization

Request Body

Section titled “ Request Body ”
Media type application/json

CreateOrgOption options for creating an organization

object
description
string
email
string
full_name
string
location
string
repo_admin_change_team_access
boolean
username
required
string
visibility

Possible values are public (default), limited or private

string
Allowed values: public limited private
website
string

Responses

Section titled “ Responses ”

201

Section titled “ 201 ”

Organization

Media type application/json

Organization represents an organization

object
avatar_url
string
created
string format: date-time
description
string
email
string
full_name
string
id
integer format: int64
location
string
name
string
repo_admin_change_team_access
boolean
username

Deprecated

string
visibility
string
website
string
Example generated 
{
  "avatar_url": "example",
  "created": "2026-04-15T12:00:00Z",
  "description": "example",
  "email": "example",
  "full_name": "example",
  "id": 1,
  "location": "example",
  "name": "example",
  "repo_admin_change_team_access": true,
  "username": "example",
  "visibility": "example",
  "website": "example"
}

403

Section titled “ 403 ”

APIForbiddenError is a forbidden error response

Media type application/json
object
message
string
url
string
Example generated 
{
  "message": "example",
  "url": "example"
}

422

Section titled “ 422 ”

APIValidationError is error format response related to input validation

Media type application/json
object
message
string
url
string
Example generated 
{
  "message": "example",
  "url": "example"
}