Skip to main content
POST
/
tournament
/
create
Create a tournament
curl --request POST \
  --url https://api.nexra.xyz/tournament/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "name": "Battle of Nexra",
  "description": "An intense tournament for top gamers",
  "entryFee": 50,
  "startTime": "2025-11-10T18:00:00Z",
  "endTime": "2025-11-10T21:00:00Z"
}
'
{
  "schema": {
    "message": "Tournament created successfully",
    "tournament": {
      "game": {
        "_id": "68f9ce6d27a07cdb23dd65c7",
        "name": "Battle Arenaa",
        "id": "68f9ce6d27a07cdb23dd65c7"
      },
      "name": "Battle of Nexra",
      "description": "An intense tournament for top gamers",
      "entryFee": 50,
      "prizePool": 0,
      "status": "pending",
      "startTime": "2025-11-10T18:00:00.000Z",
      "endTime": "2025-11-10T21:00:00.000Z",
      "winner": null,
      "_id": "68fa2b750366dd5ff66d599d",
      "createdAt": "2025-10-23T13:19:49.620Z",
      "updatedAt": "2025-10-23T13:19:49.620Z",
      "id": "68fa2b750366dd5ff66d599d"
    }
  }
}

Headers

​
x-api-key
string
required

Game API key for authentication

Example:

"abc123xyz456"

Body

application/json
​
name
string
required

Tournament name

Example:

"Battle of Nexra"

​
description
string

Tournament description

Example:

"An intense tournament for top gamers"

​
entryFee
number

Gamers entry fee for the tournament

Example:

50

​
startTime
string<date-time>

Tournament start time

Example:

"2025-11-10T18:00:00Z"

​
endTime
string<date-time>

Tournament end time

Example:

"2025-11-10T21:00:00Z"

Response

201 - application/json

Tournament created successfully