v1

latestOpenAPI 3.1.02026-07-22123157.1 KB

Create Tournament API

Creates a new tournament. Requires an Idempotency-Key header: pass a unique string per request; retrying with the same key returns the original response instead of creating a duplicate tournament. Keys are retained for 10 minutes and are scoped per token.

post/v2/tournaments

Headers

Idempotency-Keystring required

Unique string per request. Sending the same key again returns the original response instead of creating a duplicate tournament. Keys are retained for 10 minutes, scoped per token.

Request body

game_codestring required

The game to run the tournament on. Use the code value from the All Games API. Tournaments can only be created on score-based games enabled for your account — ask your Gamezop Account Manager for your eligible list.

titlestring required

Tournament title. 3 to 100 characters.

starts_atstring date-time required

Tournament start time (UTC, ISO 8601). Must be in the future, and no more than 15 days from now.

duration_secondsinteger required

Tournament duration in seconds. Minimum 300 (5 minutes), maximum 259200 (3 days). ends_at is computed as starts_at + duration_seconds.

max_score_attemptsinteger

(Optional) Maximum number of score attempts per player. Min 1, max 1000. Once a player's attempt count exceeds this cap, their leaderboard value no longer updates. If you do not provide a value, there is no attempt cap.

Example request

{
  "game_code": "B1MfIa4QCg",
  "title": "Friday 1 Hour Challenge",
  "starts_at": "2026-06-01T10:00:00Z",
  "duration_seconds": 3600,
  "max_score_attempts": 3
}

Response

Tournament created successfully. The tournament is returned in the future state.

successboolean