---
title: "Add guest members"
method: POST
path: "/groups/{groupId}/members/add-guests"
tags: ["guest users"]
---

# Add guest members

`POST /groups/{groupId}/members/add-guests`

## Request

- Base URL: `http://localhost:3001`
- URL: `http://localhost:3001/groups/{groupId}/members/add-guests`
- Auth: one of:
  - `bearer` (a scheme the document does not define)
  - HTTP bearer

Add multiple guest members to a group

## Path parameters

- `groupId` string, required

## Request body

- AddGuestMembersDto
  - `members` GuestMemberDto[], required: Array of guest members to add
    - `displayName` string, required: Display name for the guest member
    - `email` string: Optional email for invitation

## Response `200`

Guest members added successfully

- object
  - `data` AddGuestMembersResponseDto
    - `members` GuestMemberResponseDto[], required: Added members
      - `id` string, required: Member ID
      - `displayName` string, required: Display name
      - `userType` 'invited' | 'guest', required: User type
      - `canSendInvitation` boolean, required: Whether invitation can be sent
  - `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)