---
title: "Create a team for this organization."
method: POST
path: "/orgs/{org}/teams/"
tags: ["orgs"]
---

# Create a team for this organization.

`POST /orgs/{org}/teams/`

Create a team for this organization.

## Request body

- OrganizationTeamRequest
  - `description` string, nullable — A detailed description of the team.
  - `name` string, required — A descriptive name for the team.
  - `slug` string, slug
  - `visibility` 'Visible' | 'Hidden'

## Response `201`

Team created

- OrganizationTeam
  - `description` string, nullable — A detailed description of the team.
  - `name` string, required — A descriptive name for the team.
  - `slug` string, slug
  - `slug_perm` string, slug
  - `visibility` 'Visible' | 'Hidden'

## Other responses

- `400` — The team cannot be created.
- `422` — Missing or invalid parameters (see detail).

---

[API](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1.md) · [All operations](https://skmtc.dev/cloudsmith/apis/cloudsmith-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cloudsmith/cloudsmith-api-v1/revisions/4d7879df9b2f/schema)