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

# Create team

`POST /teams`

Creates a new team.

## Request body

- object
  - `organization_id` string, ulid, required — The ID of the parent organization.
  - `label` string, required — The human-readable label of the team.
  - `project_permissions` string[] — Project permissions that are granted to the team.

## Response `201`

Created

- Team
  - `id` string, ulid — The ID of the team.
  - `organization_id` string, ulid — The ID of the parent organization.
  - `label` string — The human-readable label of the team.
  - `project_permissions` string[] — Project permissions that are granted to the team.
  - `counts` object
    - `member_count` integer — Total count of members of the team.
    - `project_count` integer — Total count of projects that the team has access to.
  - `created_at` string, date-time — The date and time when the team was created.
  - `updated_at` string, date-time — The date and time when the team was last updated.

## Other responses

- `400` — Bad Request
- `403` — Forbidden

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)