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

# Create a new team

`POST /teams`

## Request

- Base URL: `https://tlsradar.com/api/v1`
- URL: `https://tlsradar.com/api/v1/teams`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://tlsradar.com/oauth/authorize`, token URL `https://tlsradar.com/oauth/token`, scopes: `read`, `write`)
  - HTTP bearer

Creates a new team owned by the authenticated user

## Request body

- object
  - `team` object, required
    - `name` string, required: Team name

## Response `201`

Team created

- Team
  - `id` string, uuid
  - `name` string
  - `status` 'active' | 'disabled'
  - `owner_id` string, uuid
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `stats` object
    - `domains_count` integer
    - `members_count` integer
    - `scan_groups_count` integer

## Other responses

- `401`: Unauthorized
- `422`: Validation error

---

[API](https://skmtc.dev/tlsradar/apis/tls-radar-api.md) · [All operations](https://skmtc.dev/tlsradar/apis/tls-radar-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tlsradar/apis/tls-radar-api/revisions/ecf1eb879b34?raw)