---
title: "Add User to Access Group"
method: PUT
path: "/access/v1/access_groups/group/user"
tags: ["Access Groups"]
---

# Add User to Access Group

`PUT /access/v1/access_groups/group/user`

Add an access user to an access group with the Verkada defined group ID and either the user defined External ID or the Verkada defined user ID.
The group ID is passed in as query parameter in the URL. The external ID or Verkada user ID(but not both) is passed in the json object in the body of the request.

## Query parameters

- `group_id` string, uuid, required — The unique identifier of the Access Group managed by Verkada.

## Request body

- PutAccessGroupRequestBodyV1
  - `external_id` string — A unique identifier managed externally provided by the customer.
  - `user_id` string, uuid — The unique identifier of the user managed by Verkada.

## Response `200`

OK

- AccessGroupAddUserResponseV1
  - `group_id` string, uuid — The unique identifier of the Access Group managed by Verkada.
  - `name` string — The unique name of the Access Group provided by the customer.
  - `successful_adds` string[] — The list of successfully added Verkada-defined user identifiers.
  - `unsuccessful_adds` string[] — The list of unsuccessfully added Verkada-defined user identifiers.

---

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