---
title: "Add group"
method: POST
path: "/groups"
tags: ["groups"]
---

# Add group

`POST /groups`

Creates a new group.

**_This operation is only available to group administrators and system administrators._**

## Request body

- object
  - `name` string — **name** (required) Must be unique within the organization account.
  - `description` string — **description** (optional)
  - `members` object[]
    - `email` string, email — Group member's email address.

## Response `200`

Result object, containing a [Group object](/api/smartsheet/openapi/groups/group) for the newly created group

- object
  - `message` 'PARTIAL_SUCCESS' | 'SUCCESS' — Message that indicates the outcome of the request. (One of `SUCCESS` or `PARTIAL_SUCCESS`.)
  - `resultCode` 0 | 3 — * '0' Success * '3' Partial Success of Bulk Operation
  - `result` Group
    - `id` number — Group ID.
    - `name` string — Group name.
    - `description` string — Group description.
    - `owner` string, email — Group owner’s email address.
    - `ownerId` number — Group owner's user ID.
    - `createdAt` union
      - string, date-time
      - number
    - `modifiedAt` union
      - string, date-time
      - number

## Other responses

- `400` — Bad Request. See Smartsheet Error Code and Message for details.
- `401` — Unauthorized. See Smartsheet Error Code and Message for details.
- `500` — Internal Server Error. See Smartsheet Error Code and Message for details.

---

[API](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference.md) · [All operations](https://skmtc.net/smartsheet/apis/smartsheet-openapi-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartsheet/smartsheet-openapi-reference/versions/b4afda95fb51/schema)