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

# Create a team

`POST /teams/create_team`

## Request body

- PlatformCreateTeamArgs
  - `defaultRegion` 'aws-us-east-1' | 'aws-eu-west-1', required
  - `name` string, required

## Response `201`

Team created successfully

- TeamResponse
  - `id` integer, required
  - `name` string, required
  - `slug` string, required
  - `creator` integer
  - `suspended` boolean, required
  - `referralCode` string, required
  - `referredBy` integer
  - `managedBy` union
    - 'vercel'
    - object
      - `oauthApp` string, required
  - `defaultRegion` 'aws-us-east-1' | 'aws-eu-west-1'
  - `ssoLoginId` string, nullable
  - `managedByUrl` string, nullable

## Other responses

- `400` — Invalid team name or deployment region
- `403` — Caller is not authorized to create teams

## Changes

- **2026-08-29** `3dd5e601c536` — 1 info
  - added the non-success response with the status `400`

[Change history](https://skmtc.dev/convex/apis/convex-management-api/changes/teams/create_team/post.md)

---

[API](https://skmtc.dev/convex/apis/convex-management-api.md) · [All operations](https://skmtc.dev/convex/apis/convex-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/convex/convex-management-api/revisions/3dd5e601c536/schema)