---
title: "Add Members to User Group"
method: POST
path: "/api/access/v1/user-groups/{userGroupId}/members"
tags: ["User Groups"]
---

# Add Members to User Group

`POST /api/access/v1/user-groups/{userGroupId}/members`

Use this API to add users as members of a specific user group. 

> 🗒 Things to Know
>
> - When a user is added as a member of a user group, the user inherits the role and organization configured for that user group. If the user belongs to other user groups, the user will still retain existing membership with those groups in addition to their other existing roles and permissions.
> - The `userId` of the users to be added to the user group can be specified in the request body in a comma separated list.

## Path parameters

- `userGroupId` string, uuid, required

## Request body

- PlatformAccessManagementAddMembersRequest
  - `members` string[] — The list of user identifiers to be added to the user group.
  - `groupId` string, uuid — The unique identifier of the user group.

## Response `201`

Created

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — User group not found
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/versions/21de3aa0b170/schema)