---
title: "Create a new team"
method: POST
path: "/teams"
tags: ["teams"]
---

# Create a new team

`POST /teams`

Create a new team.
**Access policy**: administrator

## Request body

- TeamsTeamCreatePayload
  - `Name` string, required — Name
  - `TeamLeaders` integer[] — TeamLeaders

## Response `200`

Success

- PortainerTeam
  - `DenyPortainerAccess` boolean — Whether members of this team are denied access to Portainer itself (EE only)
  - `Id` integer — Team Identifier
  - `Name` string — Team name

## Other responses

- `400` — Invalid request
- `409` — A team with the same name already exists
- `500` — Server error

---

[API](https://skmtc.net/portainer/apis/portainerce-api.md) · [All operations](https://skmtc.net/portainer/apis/portainerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/portainer/portainerce-api/versions/c0b0975cd11b/schema)