---
title: "Teams > Team > Creates"
method: POST
path: "Webhooks > Teams > Team > Creates"
tags: ["Webhooks"]
---

# Teams > Team > Creates

`POST Webhooks > Teams > Team > Creates` (webhook)

Subscription_type: `teams/team/create`

## Payload

- TeamsTeam
  - `id` string, required: Unique identifier of the team
  - `name` string, required: Human-readable name of the team (e.g. "Engineering")
  - `description` string: Free-text description of the team
  - `avatar` string: URL of the team's avatar image (null when the team has none)
  - `employee_ids` string[]: IDs of the employees who are members of this team
  - `lead_ids` string[]: IDs of the employees who are leads of this team (subset of employee_ids)
  - `company_id` string, required: ID of the company this team belongs to
  - `depth` integer: Depth of this team in the nested-team hierarchy: 1 for a top-level team, 2 for its children, and so on. Returned by read, create and move; null on update and delete, which do not change the hierarchy, and always null for companies without nested teams.
  - `parent_team_id` string: ID of the parent team this team is nested under (null for a root team). Returned by read, create and move; null on update and delete, which do not change the hierarchy, and always null for companies without nested teams.

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.dev/factorialhr/apis/factorial-api.md) - [All operations](https://skmtc.dev/factorialhr/apis/factorial-api/llms.txt) - [OpenAPI document](https://skmtc.dev/factorialhr/apis/factorial-api/revisions/83ac9aa1de50?raw)