Skip to main content
POST
Create Tournament API
Tournaments module is only available with paid plans. Contact us to know more.

About this API

Use this API to create a new tournament on any of your eligible games. Before you start, make sure you have gone through the Tournaments overview for concepts, conventions, and rate limits that apply across all Tournaments APIs.
starts_at must be in the future and within the next 15 days. ends_at is computed automatically as starts_at + duration_seconds.

API specification

Authorizations

Authorization
string
header
required

You can find the Bearer token for this API under Settings & Admin > API Tokens within the Gamezop Business Dashboard.

Headers

Idempotency-Key
string
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.

Body

application/json
game_code
string
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.

Example:

"B1MfIa4QCg"

title
string
required

Tournament title. 3 to 100 characters.

Required string length: 3 - 100
Example:

"Friday 1 Hour Challenge"

starts_at
string<date-time>
required

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

Example:

"2026-06-01T10:00:00Z"

duration_seconds
integer
required

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

Required range: 300 <= x <= 259200
Example:

3600

max_score_attempts
integer

(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.

Required range: 1 <= x <= 1000
Example:

3

Response

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

success
boolean
data
object