---
title: "Add a user to a group"
method: POST
path: "/groups/{groupId}/users"
tags: ["groups"]
---

# Add a user to a group

`POST /groups/{groupId}/users`

Adds a user to a call group. Once added, the user will receive calls routed to this group according to the group's ring strategy (simultaneous, round-robin, etc.). The user must exist in the team. If the user is already a member of the group, the request has no effect.

**Permission:** `Users Write` required.

**Monitoring:** **Required.** Group membership management is a supervisory operation. Returns `401 Unauthorized` if Monitoring is OFF on your API key.

## Path parameters

- `groupId` integer, required

## Request body

- integer[]

## Response `200`

Successful operation

## Other responses

- `400` — The provided group ID or request body is invalid
- `401` — Authentication token is missing, invalid, expired, Users Write permission is missing, or monitoring is not enabled
- `404` — No group found with the specified ID
- `500` — Internal server error

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)