---
title: "Create Team"
method: POST
path: "/v0/organizations/{organization_id}/teams"
tags: ["Teams & Resource Access"]
---

# Create Team

`POST /v0/organizations/{organization_id}/teams`

Create a new team in an organization.

Requires org:write permission (Owner and Admin roles have this).

:param request_fastapi: FastAPI request object.
:param organization_id: Organization ID.
:param team_data: Team creation data.
:param session: Database session.
:return: Created team.

## Path parameters

- `organization_id` integer, required

## Request body

- TeamCreate — Schema for creating a team.
  - `name` string, required
  - `description` string, nullable

## Response `201`

Successful Response

- TeamResponse — Schema for team response.
  - `id` integer, required
  - `name` string, required
  - `description` string, nullable, required
  - `organization_id` integer, required
  - `created_at` string, date-time, required
  - `member_count` integer, nullable
  - `members` string[], nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unify/apis/unifyai-http-api-reference.md) · [All operations](https://skmtc.net/unify/apis/unifyai-http-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unify/unifyai-http-api-reference/revisions/900377f918b6/schema)