Skip to main content

How to Create a Group to Send Messages

Group chats let you message several people in one conversation. Here’s how to create a group and send messages in it.

In the app (UI)​

  1. Log in and open Messages.
  2. Start a new conversation (e.g. “New message” or “New chat”).
  3. Choose Create group or New group (wording may vary).
  4. Enter a group name (e.g. “Project Team”).
  5. Optionally add a description.
  6. Add members: Search and select the people you want in the group, then confirm.
  7. Create the group. You’ll enter the group chat; type and send messages as in a direct chat. Everyone in the group will see the messages.

To add or remove members later, open the group and use the group options/settings (e.g. “Add members”, “Leave group”).

Via the API​

Create a group:

POST /api/Chat/groups
Authorization: Bearer {token}
Content-Type: application/json

{
  "name": "Project Team",
  "description": "Team discussion for the project",
  "memberIds": ["user-id-1", "user-id-2", "user-id-3"],
  "avatar": "optional-avatar-url"
}

Send a message in the group:
Use the same message API with the group’s conversationId (or the endpoint that accepts a conversation ID). See Messaging feature for sending to a conversation.

Add members later:

POST /api/Chat/groups/{conversationId}/participants
Authorization: Bearer {token}
Content-Type: application/json

{ "memberIds": ["user-id-4", "user-id-5"] }

Leave group: Use the leave endpoint (e.g. POST /api/Chat/conversations/{conversationId}/leave or as documented).

Next steps​