---
title: "Add members to a group conversation (creator only)"
method: POST
path: "/conversations/{id}/members"
tags: ["Conversations"]
---

# Add members to a group conversation (creator only)

`POST /conversations/{id}/members`

## Request

- Base URL: `https://api.shopseen.com/v1`
- URL: `https://api.shopseen.com/v1/conversations/{id}/members`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `user_ids` string[], required

## Response `200`

Members added

- object
  - `conversation` Conversation
    - `id` string, uuid
    - `conversation_type` 'direct' | 'group'
    - `name` string, nullable
    - `created_by` string, uuid, nullable
    - `user_a_id` string, uuid, nullable
    - `user_b_id` string, uuid, nullable
    - `created_at` string, date-time
    - `last_message_at` string, date-time, nullable
    - `last_read_at` string, date-time, nullable
    - `unread_count` integer
    - `other_user_id` string, uuid, nullable
    - `other_display_name` string, nullable
    - `other_avatar_url` string, nullable
    - `members` UserProfile[], nullable
      - `id` string, uuid
      - `display_name` string
      - `avatar_url` string, nullable
      - `bio` string, nullable
      - `is_mutual_follow` boolean
      - `is_following` boolean
      - `is_followed_by` boolean: True if this user follows the authenticated user
      - `mutual_follow_count` integer

---

[API](https://skmtc.dev/shopseen/apis/a-side-api.md) - [All operations](https://skmtc.dev/shopseen/apis/a-side-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shopseen/apis/a-side-api/revisions/f37f989e90da?raw)