---
title: "Add group members"
method: POST
path: "/groups/{groupId}/members"
tags: ["groupMembers"]
---

# Add group members

`POST /groups/{groupId}/members`

Adds one or more members to a group.

**_This operation supports both single-object and bulk semantics. For more information, see Optional Bulk Operations._**

If called with a single [GroupMember object](/api/smartsheet/openapi/groupmembers/groupmember), and that group member already exists, error code **1129** is returned.
If called with an array of [GroupMember objects](/api/smartsheet/openapi/groupmembers/groupmember), any users specified in the array that are already group members are ignored and omitted from the response.

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

## Request body

- union
  - GroupMember
    - `id` number — Group member's user ID.
    - `email` string, email — Group member's email address.
    - `firstName` string — Group member's first name.
    - `lastName` string — Group member's last name.
    - `name` string — Group member's full name.
  - GroupMember[]
    - `id` number — Group member's user ID.
    - `email` string, email — Group member's email address.
    - `firstName` string — Group member's first name.
    - `lastName` string — Group member's last name.
    - `name` string — Group member's full name.

## Response `200`

Returns a Result object containing the members added to the group -- either a single [GroupMember](/api/smartsheet/openapi/groupmembers/groupmember) or array of [GroupMember](/api/smartsheet/openapi/groupmembers/groupmember) objects, corresponding to what was specified in the request.

**_This operation is asynchronous,_** _meaning the users may not yet have sharing access to sheets for a period of time after this operation returns. For small groups with limited sharing, the operation should complete quickly (within a few seconds). For large groups with many shares, this operation could possibly take more than a minute to complete._

- 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` union
    - GroupMember
      - `id` number — Group member's user ID.
      - `email` string, email — Group member's email address.
      - `firstName` string — Group member's first name.
      - `lastName` string — Group member's last name.
      - `name` string — Group member's full name.
    - GroupMember[]
      - `id` number — Group member's user ID.
      - `email` string, email — Group member's email address.
      - `firstName` string — Group member's first name.
      - `lastName` string — Group member's last name.
      - `name` string — Group member's full name.

## Other responses

- `default` — If an error occurs because the request specified one or more alternate email addresses, please retry using the primary email address.

---

[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)