---
title: "Adds a user to the group"
method: POST
path: "/workspaces/{workspace_domain}/groups/{group_id}/members"
tags: ["Group API"]
---

# Adds a user to the group

`POST /workspaces/{workspace_domain}/groups/{group_id}/members`

## Path parameters

- `workspace_domain` string, required
- `group_id` integer, required

## Request body

- AddGroupMemberRequest
  - `id` integer, required — The ID of the user
  - `status` 'MEMBER' | 'MANAGER' — The status of the group member

## Response `200`

- GroupMemberView
  - `url` string — API endpoint to GET this object
  - `html_url` string — Web URL to view this object in Buddy.works
  - `id` integer — The ID of the user
  - `name` string — The name of the user
  - `avatar_url` string — The avatar URL of the user
  - `email` string — The email address of the user
  - `admin` boolean — Whether the user has admin privileges
  - `workspace_owner` boolean — Whether the user is workspace owner
  - `status` 'MEMBER' | 'MANAGER' — The status of the group member

## Changes

- **2026-08-25** `fa785a68f09d` — 2 info
  - the security scope `GROUP_WRITE` was added to the endpoint's security scheme `oauth2`
  - the security scope `WORKSPACE` was removed from the endpoint's security scheme `oauth2`

[Change history](https://skmtc.dev/buddy/apis/buddy-api/changes/workspaces/:workspace_domain/groups/:group_id/members/post.md)

---

[API](https://skmtc.dev/buddy/apis/buddy-api.md) · [All operations](https://skmtc.dev/buddy/apis/buddy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/buddy/buddy-api/revisions/fa785a68f09d/schema)