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

# Create a new team

`POST /v2/teams`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/teams`
- Auth: OAuth 2
  - Authorization code: `https://oauth.qonto.com/oauth2/auth`
  - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `team.write`

OAuth scope: `team.write`

---

Create a new team in the authenticated organization.

---

A successful response will give name and id of the newly created team.

## Headers

- `X-Qonto-Staging-Token` string

## Request body

- object
  - `name` string, required: name for the new team being created

## Response `201`

returns created team

- object
  - `team` object
    - `id` string, uuid: unique identifier of the newly created team
    - `name` string: name of the newly created team

## Other responses

- `401`: returns an unauthorized error
- `403`: returns a forbidden error
- `422`: returns an unprocessable entity error

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)