# Create an organization

From **GitHub v3 REST API**.

`POST /admin/organizations`

Create an organization

## Request body

- Required: true
### `application/json`

- Type: `object`

```json
{
  "admin": "monalisaoctocat",
  "login": "github",
  "profile_name": "GitHub, Inc."
}
```

```json
{"properties":{"admin":{"description":"The login of the user who will manage this organization.","type":"string"},"login":{"description":"The organization's username.","type":"string"},"profile_name":{"description":"The organization's display name.","type":"string"}},"required":["login","admin"],"type":"object"}
```

## Responses

### `201`

Response

### `application/json`

- Type: `object`

Organization Simple

```json
{
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "description": "A great organization",
  "events_url": "https://api.github.com/orgs/github/events",
  "hooks_url": "https://api.github.com/orgs/github/hooks",
  "id": 1,
  "issues_url": "https://api.github.com/orgs/github/issues",
  "login": "github",
  "members_url": "https://api.github.com/orgs/github/members{/member}",
  "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=",
  "public_members_url": "https://api.github.com/orgs/github/public_members{/member}",
  "repos_url": "https://api.github.com/orgs/github/repos",
  "url": "https://api.github.com/orgs/github"
}
```

```json
{"description":"Organization Simple","properties":{"avatar_url":{"example":"https://github.com/images/error/octocat_happy.gif","type":"string"},"description":{"example":"A great organization","nullable":true,"type":"string"},"events_url":{"example":"https://api.github.com/orgs/github/events","format":"uri","type":"string"},"hooks_url":{"example":"https://api.github.com/orgs/github/hooks","type":"string"},"id":{"example":1,"type":"integer"},"issues_url":{"example":"https://api.github.com/orgs/github/issues","type":"string"},"login":{"example":"github","type":"string"},"members_url":{"example":"https://api.github.com/orgs/github/members{/member}","type":"string"},"node_id":{"example":"MDEyOk9yZ2FuaXphdGlvbjE=","type":"string"},"public_members_url":{"example":"https://api.github.com/orgs/github/public_members{/member}","type":"string"},"repos_url":{"example":"https://api.github.com/orgs/github/repos","format":"uri","type":"string"},"url":{"example":"https://api.github.com/orgs/github","format":"uri","type":"string"}},"required":["login","url","id","node_id","repos_url","events_url","hooks_url","issues_url","members_url","public_members_url","avatar_url","description"],"title":"Organization Simple","type":"object"}
```

## Request examples

### cURL

```shell
curl --request POST \
  --url {protocol}://{hostname}/api/v3/admin/organizations \
  --header 'content-type: application/json' \
  --data '{
  "admin": "monalisaoctocat",
  "login": "github",
  "profile_name": "GitHub, Inc."
}'
```