Skip to main content
POST
/
lobbies
Create a new lobby
curl --request POST \
  --url https://api.engagefabric.com/lobbies \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Epic Battle Room",
  "description": "<string>",
  "maxSize": 10,
  "privacy": "PUBLIC",
  "gameMode": "deathmatch",
  "difficulty": "hard",
  "password": "secret123",
  "config": {
    "mapSeed": 12345,
    "challengeId": "challenge-1"
  },
  "metadata": {}
}
'

Query Parameters

​
projectId
string
required
​
playerId
string
required

Body

application/json
​
name
string
required

Lobby name

Example:

"Epic Battle Room"

​
description
string

Lobby description

​
maxSize
number
default:10

Maximum number of players

Required range: 2 <= x <= 100
​
privacy
enum<string>
default:PUBLIC

Lobby privacy setting

Available options:
PUBLIC,
PRIVATE,
INVITE_ONLY,
FRIENDS
​
gameMode
string

Game mode

Example:

"deathmatch"

​
difficulty
string

Difficulty level

Example:

"hard"

​
password
string

Password for private lobbies

Example:

"secret123"

​
config
object

Custom configuration

Example:
{
  "mapSeed": 12345,
  "challengeId": "challenge-1"
}
​
metadata
object

Additional metadata

Response

Lobby created successfully