# Matchmaking

## Motivation

**coherence** provides a powerful matchmaking API with various different setups (multiple teams, team sizes, etc.).

## Configuration

Before using the matchmaking service you have to configure it on the Developer Portal. Currently there are two things to set up: the timeout and the teams.

![](https://3798176112-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZcBSvjNQZSas5L9C0K8K%2Fuploads%2Fw0WaqGVJ6mm5LnjBeV5O%2FScreenshot_2021-05-26_20-35-01.png?alt=media)

The timeout is in seconds. There can be any number of teams and any number of players per team.

For example, a chess game would need only one team with two players, while in a soccer game you'd need two teams with eleven players per team.

## Using the matchmaking

Please refer to the [Cloud API: Matchmaking.](https://docs.coherence.io/0.9/api-reference/cloud-api/matchmaking)