---
title: "Create Team"
method: POST
path: "/team-messaging/v1/teams"
tags: ["Teams"]
---

# Create Team

`POST /team-messaging/v1/teams`

Creates a team, and adds a list of people to the team.

## Request body

- TMCreateTeamRequest
  - `public` boolean — Team access level.
  - `name` string, required — Team name.
  - `description` string — Team description.
  - `members` object[] — Identifier(s) of team members.
    - `id` string — Internal identifier of a person
    - `email` string, email — Email of a person

## Response `201`

Created

- TMTeamInfo
  - `id` string — Internal identifier of a team
  - `type` 'Team' — Type of chat
  - `public` boolean — Team access level
  - `name` string — Team name
  - `description` string — Team description
  - `status` 'Active' | 'Archived' — Team status
  - `creationTime` string, date-time — Team creation datetime in ISO 8601 format
  - `lastModifiedTime` string, date-time — Team last change datetime in ISO 8601 format

## Other responses

- `400` — One of body parameters has invalid value.

---

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