---
title: "Create a group"
method: POST
path: "/teams/{team_id}/groups"
tags: ["Team Groups"]
---

# Create a group

`POST /teams/{team_id}/groups`

Creates a group in the team. Requires *Admin* right in the team.

If `is_admin` flag is set to `true`, the group would automatically get access to all project languages, overriding supplied `languages` object.

Requires <code>write_team_groups</code> OAuth access scope.

## Path parameters

- `team_id` number, required

## Request body

- object
  - `name` string, required — Name of the group.
  - `is_reviewer` boolean, required — Whether the group has reviewer access to the project. From the new permission release onwards is deprecated.
  - `is_admin` boolean, required — Whether the group has Admin access to the project. From the new permission release onwards is deprecated.
  - `role_id` 1 | 2 | 3 | 4 | 5 — Permission template id to grab permissions from, if provided admin_rights is ignored.
  - `admin_rights` string[] — List of group permissions. Possible values are <code>activity</code>,<code>contributors</code>,<code>branches_create</code>,<code>branches_main_modify</code>,<code>branches_merge</code>,<code>custom_status_modify</code>,<code>download</code>,<code>glossary</code>,<code>glossary_edit</code>,<code>glossary_delete</code>,<code>keys</code>,<code>manage_languages</code>,<code>review</code>,<code>screenshots</code>,<code>settings</code>,<code>statistics</code>,<code>tasks</code>,<code>upload</code>.
  - `languages` object — <code>Required</code> if group doesn't have admin rights.
    - `reference` string[] — List of reference language IDs for the group
    - `contributable` string[] — List of contributable language IDs for the group

## Response `200`

OK

- object
  - `team_id` integer
  - `group` TeamUserGroups
    - `group_id` number — A unique identifier of the group.
    - `name` string — Name of the group.
    - `permissions` object — List of group permissions.
      - `is_admin` boolean — Whether the user has Admin access to the project. From the new permission release onwards is deprecated.
      - `is_reviewer` boolean — Whether the user has Reviewer access to the project. From the new permission release onwards is deprecated.
      - `admin_rights` unknown[] — List of group administrative permissions.
        - unknown
      - `languages` object[] — List of languages, accessible to the user.
        - `lang_id` number — Language ID.
        - `lang_iso` string — Language code.
        - `lang_name` string — Language name.
        - `is_writable` boolean — Whether the user has write access to the language.
    - `created_at` string — Date/time at which the group was created.
    - `created_at_timestamp` number — Unix timestamp when the group was created.
    - `team_id` number — Team identifier.
    - `projects` unknown[] — List of projects, group is added to.
      - unknown
    - `members` unknown[] — List of group members (user IDs).
      - unknown
    - `role_id` 1 | 2 | 3 | 4 | 5 — Permission template id attached to the group.

---

[API](https://skmtc.net/lokalise/apis/default-projects.md) · [All operations](https://skmtc.net/lokalise/apis/default-projects/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lokalise/default-projects/versions/7bceba421b12/schema)