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.
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
You can find the Bearer token for this API under Settings & Admin > API Tokens within the Gamezop Business Dashboard.
Headers
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
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.
"B1MfIa4QCg"
Tournament title. 3 to 100 characters.
3 - 100"Friday 1 Hour Challenge"
Tournament start time (UTC, ISO 8601). Must be in the future, and no more than 15 days from now.
"2026-06-01T10:00:00Z"
Tournament duration in seconds. Minimum 300 (5 minutes), maximum 259200 (3 days). ends_at is computed as starts_at + duration_seconds.
300 <= x <= 2592003600
(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.
1 <= x <= 10003