---
title: "Add an ACS User to an Access Group"
method: POST
path: "/acs/access_groups/add_user"
tags: ["/acs"]
---

# Add an ACS User to an Access Group

`POST /acs/access_groups/add_user`

Adds a specified [access system user](/low-level-apis/access-systems/user-management) to a specified [access group](/low-level-apis/access-systems/user-management/assigning-users-to-access-groups).

## Request body

- object
  - `acs_access_group_id` string, uuid, required — ID of the access group to which you want to add an access system user.
  - `acs_user_id` string, uuid — ID of the access system user that you want to add to an access group. You can only provide one of acs_user_id or user_identity_id.
  - `user_identity_id` string, uuid — ID of the desired user identity that you want to add to an access group. You can only provide one of acs_user_id or user_identity_id. If the ACS system contains an ACS user with the same `email_address` or `phone_number` as the user identity that you specify, they are linked, and the access group membership belongs to the ACS user. If the ACS system does not have a corresponding ACS user, one is created.

## Response `200`

OK

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.net/seam/apis/seam-connect.md) · [All operations](https://skmtc.net/seam/apis/seam-connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/seam/seam-connect/versions/00c35395ce12/schema)