---
title: "addPlayers(to:matchRequest:completionHandler:)"
framework: gamekit
role: symbol
role_heading: Instance Method
path: "gamekit/gkmatchmaker/addplayers(to:matchrequest:completionhandler:)"
---

# addPlayers(to:matchRequest:completionHandler:)

Invites additional players to an existing match.

## Declaration

```swift
func addPlayers(to match: GKMatch, matchRequest: GKMatchRequest, completionHandler: (@Sendable ((any Error)?) -> Void)? = nil)
```

```swift
func addPlayers(to match: GKMatch, matchRequest: GKMatchRequest) async throws
```

## Parameters

- `match`: The match to which GameKit adds the players.
- `matchRequest`: The configuration for the match.
- `completionHandler`: The block that GameKit calls when it completes the request. This block receives the following parameters:

## Mentioned in

Finding players for custom server-based games

## Discussion

Discussion Use this method to add more players to an existing match that doesn’t have enough players. important: Invoke this method for only one player connected to the match.

## See Also

### Matching players

- [findMatch(for:withCompletionHandler:)](gamekit/gkmatchmaker/findmatch(for:withcompletionhandler:).md)
- [findPlayers(forHostedRequest:withCompletionHandler:)](gamekit/gkmatchmaker/findplayers(forhostedrequest:withcompletionhandler:).md)
- [findMatchedPlayers(_:withCompletionHandler:)](gamekit/gkmatchmaker/findmatchedplayers(_:withcompletionhandler:).md)
- [GKMatchedPlayers](gamekit/gkmatchedplayers.md)
- [finishMatchmaking(for:)](gamekit/gkmatchmaker/finishmatchmaking(for:).md)
- [cancel()](gamekit/gkmatchmaker/cancel().md)
- [cancelPendingInvite(to:)](gamekit/gkmatchmaker/cancelpendinginvite(to:).md)