---
search:
  tags:
    - teams
    - POST
seo:
  description: >-
    Creates a new team with the specified name, icon, and members. Reference for
    the POST /teams endpoint in the Leadtime Public API API.
sidebar:
  badge: POST
  label: Create a new team
title: Create a new team
type: openapi-operation
---
Creates a new team with the specified name, icon, and members.

**How to create a team:**
1. Provide a team name (required) - choose any descriptive name
2. Select an icon emoji (required) - used for visual identification
3. Assign at least one user to the team (required) - provide an array of user IDs

**Validation rules:**
- Team name must be a non-empty string
- Icon must be a non-empty string (typically an emoji)
- Users array must contain at least one user ID
- All user IDs must be valid UUIDs of existing employees in the workspace

**What happens after creation:**
- The team is immediately available for project assignments
- Team members can be granted access to projects as a group
- The team appears in team lists and can be used for filtering
- The team can be edited or deleted later

**What is returned:**
- Complete team details including the generated team ID
- All assigned members with their information
- Team metadata (name, icon, user count)

**Note:** This endpoint requires the Teams.create permission.

<Operation source="api-reference" id="teamscontroller-createteam" />