---
title: "Create a New Group"
method: POST
path: "/api/v2/groups"
tags: ["Group"]
---

# Create a New Group

`POST /api/v2/groups`

This endpoint creates a new group in the system. <h2>Scope Required</h2>`groups:write`

## Request body

- V2GroupsBody
  - `data` Apiv2groupsData
    - `type` string
    - `attributes` Apiv2groupsDataAttributes
      - `name` string, nullable, required — The title of the group.
      - `description` string, nullable, required — The description of the group.
      - `privacy` string — The privacy setting for this group. Can be `Open`, `Closed`, `Private` and `Administrative`. Global Admin Tool Organizations privacy settings can be `Open` and `Private`.
      - `group-type` string — Specifies the type of Group. Can either be `Group` or `ManagerGroup`

## Response `201`

Success

- ListedGroup
  - `links` SelfWithNextLink
    - `self` string
    - `next` string
  - `data` ListedGroupData[]
    - `type` string
    - `id` string
    - `attributes` ListedGroupAttributes
      - `name` string, nullable — The name of the group.
      - `description` string, nullable — Short description of the group.
      - `privacy` string, nullable — Privacy setting for the group.
      - `external-group-id` string, nullable — External identifier of the group.
      - `created-at` string, date-time — Date that the group was created. (UTC)
    - `links` SelfLink
      - `self` string
    - `relationships` CreatedByUserRelationshipsInner[]
      - `created_by` UserRelationshipsInnerUser
        - `data` UserRelationshipData
          - `id` string, nullable
          - `type` string, nullable

---

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