---
title: "createGroupChat(_:)"
framework: TelephonyMessagingKit
role: symbol
role_heading: Instance Method
platforms: [iOS 26.0+]
path: "telephonymessagingkit/rcsservice/creategroupchat(_:)"
---

# createGroupChat(_:)

Creates a group with a list of participants and a specified subject.

## Declaration

```swift
final func createGroupChat(_ request: RCSService.CreateGroupChatRequest) async throws -> RCSService.CreateGroupChatRequest.Result
```

## Parameters

- `request`: Request specifying the group to create.

## Return Value

Return Value A RCSService.CreateGroupChatRequest.Result that contains the group handle for the group.

## Discussion

Discussion note: If the messaging service doesn’t support group chat, this method throws RCSService.Error.notSupported. If the group chat size exceeds the maximum allowed size, this method throws RCSService.Error.maximumSizeExceeded.

## See Also

### Managing group chats

- [RCSService.CreateGroupChatRequest](telephonymessagingkit/rcsservice/creategroupchatrequest.md)
- [leaveGroupChat(_:)](telephonymessagingkit/rcsservice/leavegroupchat(_:).md)
- [RCSService.LeaveGroupChatRequest](telephonymessagingkit/rcsservice/leavegroupchatrequest.md)
- [addGroupChatParticipants(_:)](telephonymessagingkit/rcsservice/addgroupchatparticipants(_:).md)
- [RCSService.AddGroupChatParticipantsRequest](telephonymessagingkit/rcsservice/addgroupchatparticipantsrequest.md)
- [removeGroupChatParticipants(_:)](telephonymessagingkit/rcsservice/removegroupchatparticipants(_:).md)
- [RCSService.RemoveGroupChatParticipantsRequest](telephonymessagingkit/rcsservice/removegroupchatparticipantsrequest.md)
- [changeGroupChatSubject(_:)](telephonymessagingkit/rcsservice/changegroupchatsubject(_:).md)
- [RCSService.ChangeGroupChatSubjectRequest](telephonymessagingkit/rcsservice/changegroupchatsubjectrequest.md)
- [groupChatEvents](telephonymessagingkit/rcsservice/groupchatevents.md)
- [RCSService.GroupChatEvent](telephonymessagingkit/rcsservice/groupchatevent.md)