---
title: "👤 Create a team. Admin is not required."
method: POST
path: "/team/create"
tags: ["team", "default"]
---

# 👤 Create a team. Admin is not required.

`POST /team/create`

## Request

- Base URL: `{{ server_url }}/v1`
- URL: `{{ server_url }}/v1/team/create`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/athenian/apis/title/docs/team/create/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- TeamCreateRequest: Team creation request.
  - `account` integer, required: Account identifier. That account will own the created team.
  - `name` string, required: Name of the team.
  - `members` DeveloperID[], required: A set of developers. An empty list disables the filter and includes everybody. Duplicates are automatically ignored.
  - `parent` integer, nullable, required: Identifier of the higher level team.

## Response `200`

Identifier of the created team.

- CreatedIdentifier
  - `id` integer, required: Identifier of the created entity.

## Other responses

- `400`: The request is invalid.
- `409`: There is an existing team with the same name.

---

[API](https://skmtc.dev/athenian/apis/title.md) - [All operations](https://skmtc.dev/athenian/apis/title/llms.txt) - [OpenAPI document](https://skmtc.dev/athenian/apis/title/revisions/110c9f7cffdd?raw)