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

# Create a team

`POST /api/teams`

## Request body

- object
  - `name` string, required — Name of the team.
  - `description` string, nullable — Longer description of the team.
  - `decoration` object, nullable — Object describing how the team appears on the webpage. Currently only supports `emoji` field that shows before the team's name.
  - `members` object[] — The list of users within the team.
    - `id` integer — ID of the object
    - `name` string, nullable — The full name of the user
    - `email` string, email, nullable — The email address of the user
    - `meta` unknown

## Response `201`

The created team.

- Team — A `Team` represents a group of [users](#user-object). Teams are used with the "auto-assign tickets" feature: you can assign a ticket to a team (manually of via rules), then it will be automatically assigned to someone who is available in the given team.
  - `id` integer — ID of the team.
  - `uri` string — URI of the object (auto-generated)
  - `name` string — Name of the team.
  - `description` string, nullable — Longer description of the team.
  - `decoration` object, nullable — Object describing how the team appears on the webpage. Currently only supports `emoji` field that shows before the team's name.
  - `members` object[] — The list of users within the team.
    - `id` integer — ID of the object
    - `name` string, nullable — The full name of the user
    - `email` string, email, nullable — The email address of the user
    - `meta` unknown
  - `created_datetime` string, date-time, nullable — When the team was created.

---

[API](https://skmtc.net/gorgias/apis/gorgias-rest-api.md) · [All operations](https://skmtc.net/gorgias/apis/gorgias-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gorgias/gorgias-rest-api/versions/36f2e31f4e81/schema)