---
title: "Add member to group"
method: POST
path: "/groups/{id}/members"
tags: ["groups"]
---

# Add member to group

`POST /groups/{id}/members`

## Request

- Base URL: `http://localhost:3001`
- URL: `http://localhost:3001/groups/{id}/members`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Adds a new member to a group (admin only)

## Path parameters

- `id` string, required

## Request body

- AddMemberDto

## Response `200`

Member added to group successfully

- object
  - `data` GroupMemberResponseDto
    - `id` string, required
    - `userId` string, required
    - `displayName` string, required
    - `email` string, required
    - `role` 'admin' | 'member', required
    - `joinedAt` string, required: ISO timestamp when the user joined
    - `leftAt` string, nullable, required
    - `avatarUrl` string, nullable
    - `displayOrder` number, nullable: Custom display order for this membership
    - `overrideIcon` string, nullable
    - `overrideColor` string, nullable
  - `success` boolean
  - `message` string

## Other responses

- `400`: Bad Request - Invalid input or validation failed
- `401`: Unauthorized - Authentication required or invalid token
- `403`: Forbidden - Insufficient permissions to access this resource
- `404`: Not Found - The requested resource does not exist
- `500`: Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.dev/spliteo/apis/spliteo-api.md) · [All operations](https://skmtc.dev/spliteo/apis/spliteo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spliteo/apis/spliteo-api/revisions/bd9b84f4e407?raw)