---
title: "Create a child team"
method: POST
path: "/team/create-team"
tags: ["teams"]
---

# Create a child team

`POST /team/create-team`

Create a new child team under the authenticated team

## Request body

- object
  - `team_name` string, required — Name of the new team
  - `owner_email` string — Email of the team owner. If omitted, the current team's owner is used.
  - `company_website` string — Company website to use for automatic network mapping. Cannot be combined with company_linkedin_url.
  - `company_linkedin_url` string — Company LinkedIn URL to use for automatic network mapping. Cannot be combined with company_website.

## Response `200`

Team created successfully

- object
  - `team_id` string, uuid, required — ID of the newly created team

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Team owner not found
- `409` — Team name already exists
- `5XX` — Unexpected error

---

[API](https://skmtc.net/theswarm/apis/swarm-api.md) · [All operations](https://skmtc.net/theswarm/apis/swarm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/theswarm/swarm-api/revisions/55bbdd2aa713/schema)
