---
title: "POST /v0.1/orgs/{org_name}/teams"
method: POST
path: "/v0.1/orgs/{org_name}/teams"
tags: ["account"]
---

# POST /v0.1/orgs/{org_name}/teams

`POST /v0.1/orgs/{org_name}/teams`

## Request

- Base URL: `https://api.appcenter.ms`
- URL: `https://api.appcenter.ms/v0.1/orgs/{org_name}/teams`
- Auth: API key in header `X-API-Token`
- TypeScript: <https://skmtc.dev/appcenter/apis/app-center-client/docs/v0.1/orgs/:org_name/teams/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates a team and returns it

## Path parameters

- `org_name` string, required

## Request body

- object
  - `display_name` string, required: The display name of the team
  - `name` string: The name of the team
  - `description` string: The description of the team

## Response `201`

Success

- object[]
  - `id` string, uuid, required: The internal unique id (UUID) of the team.
  - `name` string, required: The name of the team
  - `display_name` string, required: The display name of the team
  - `description` string: The description of the team

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/appcenter/apis/app-center-client.md) - [All operations](https://skmtc.dev/appcenter/apis/app-center-client/llms.txt) - [OpenAPI document](https://skmtc.dev/appcenter/apis/app-center-client/revisions/4e9226ab8f35?raw)