Skip to main content
POST
/
:projectId
/
api
/
v7
/
conversations
Create Group Conversation
curl --request POST \
  --url https://api.replyke.com/api/v6/:projectId/api/v7/conversations \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "<string>",
  "name": "<string>",
  "description": "<string>",
  "memberIds": [
    "<string>"
  ],
  "metadata": {}
}
'
Creates a group conversation. The caller is automatically added as an admin. All provided memberIds are validated to belong to the project and added as member.

​
Body Parameters

​
type
string
required
Must be "group".
​
name
string
Display name of the conversation. Maximum 200 characters. Optional.
​
description
string
Optional description for the conversation. Maximum 1000 characters.
​
memberIds
string[]
Array of user IDs to add to the conversation. Defaults to []. The caller’s own ID is ignored if included — they are always added as admin. All IDs must belong to the same project.
​
metadata
object
Custom key-value data to attach to the conversation. Optional.

​
Response

Returns the created Conversation object with HTTP 201.

​
Error Responses

{ "error": "User 'abc' does not belong to this project.", "code": "chat/invalid-member" }
One or more provided user IDs do not exist in this project.