Challonge API Docs
  1. Tournaments
Challonge API Docs
  • Guides
    • Welcome
    • Changelog
    • Upgrading
      • Upgrading from v2.0 to v2.1
    • Sample Use Cases
      • Running a Two-Stage Tournament
    • Challonge Connect
      • About
      • Game Integration (beta)
      • Connect Request Signing
  • API v2.1
    • Getting Started
    • Authorization
    • Error Responses
    • Resource Scoping
    • OAuth
      • Scopes
      • Grant Request
      • Token Request
      • Refresh Token Request
      • Device Grant Authorization Request
      • Device Grant Access Token Request
    • Tournament API
      • Tournaments
        • Tournament States
        • List Tournaments
        • Create Tournament
        • Get Tournament
        • Update Tournament
        • Delete Tournament
        • Change Tournament State
      • Participants
        • List Participants
        • Create Participant
        • Get Participant
        • Update Participant
        • Delete Participant
        • Bulk Create Participants
        • Clear All Participants
        • Randomize Participants
        • Register Me
      • Matches
        • List Matches
        • Get Match
        • Update Match
        • Change Match State
      • Match Attachments
        • List Match Attachments
        • Create Match Attachment
        • Delete Match Attachment
    • Race API
      • Races
        • List Races
        • Create Race
        • Get Race
        • Update Race
        • Delete Race
        • Change Race State
      • Rounds
        • List Rounds
        • Get Round
        • Update Round
      • Elapsed Times
        • List Elapsed Times
        • Get Elapsed Time
        • Update Elapsed Time
        • Bulk Update Elapsed Times
    • Get User
      GET
    • List Communities
      GET
    • Schemas
      • MatchAttachmentModel
      • MatchAttachmentInput
      • MatchAttachmentOutput
      • MatchAttachment
      • ParticipantModel
      • ParticipantOutput
      • ParticipantInput
      • ParticipantBulkInput
      • Participant
      • TournamentModel
      • TournamentInput
      • Tournament
      • TournamentStateInput
      • CommunityModel
      • Community
      • MatchModel
      • MatchInput
      • MatchOutput
      • Match
      • MatchStateInput
      • ErrorModel
      • UserModel
      • User
      • ElapsedTimeBulkInput
      • ElapsedTimeWithID
      • ElapsedTimeOutput
      • ElaspedTimeInput
      • Timestamps
      • RelationshipLink
      • RoundOutput
      • RoundStateInput
      • RacingOutput
      • RacingInput
      • RacingStateInput
  • Bracket JSAPI v1.0
    • Getting Started
    • Broadcasted Events
    • API Actions
      • scrollToCoordinates
      • scrollToMatchIdentifier
      • setZoomScale
      • zoomToCoordinate
      • zoomToMatchIdentifier
      • loadTheme
      • filterRounds
      • loadIntegrationData
      • setBracketSettings
  • API v2.0 (deprecated)
    • About
    • Deprecated Endpoints
      • Tournament
        • findTournaments
        • createTournament
        • showTournament
        • updateTournament
        • deleteTournament
        • changeStateTournament
      • Match
        • findMatches
        • showMatch
        • updateMatch
        • changeStateTournament
      • Participant
        • findParticipants
        • createParticipant
        • showParticipant
        • updateParticipant
        • deleteParticipant
        • bulkCreateParticipant
        • clearAllParticipants
        • randomizeParticipants
      • Match Attachment
        • findMatchAttachments
        • createMatchAttachments
        • deleteMatchAttachment
      • Race
        • findRaces
        • createRace
        • showRace
        • updateRace
        • deleteRace
        • changeStateRace
      • Round
        • findRounds
        • showRound
        • updateRound
      • Elapsed Time
        • findElapsedTime
        • showElapsedTime
        • updateElapsedTime
        • bulkUpdateElapsedTime
      • User
        • findUser
        • findCommunities
    • Schemas
      • MatchAttachmentModel
      • MatchAttachmentInput
      • MatchAttachmentOutput
      • MatchAttachment
      • ParticipantModel
      • ParticipantOutput
      • ParticipantInput
      • ParticipantBulkInput
      • Participant
      • TournamentModel
      • TournamentInput
      • Tournament
      • TournamentStateInput
      • CommunityModel
      • Community
      • MatchModel
      • MatchInput
      • MatchOutput
      • Match
      • MatchStateInput
      • ErrorModel
      • UserModel
      • User
      • ElapsedTimeBulkInput
      • ElapsedTimeWithID
      • ElapsedTimeOutput
      • ElaspedTimeInput
      • Timestamps
      • RelationshipLink
      • RoundOutput
      • RoundStateInput
      • RacingOutput
      • RacingInput
      • RacingStateInput
  • API v1 (deprecated)
    • About
    • Deprecated Endpoints
      • Tournaments
        • List tournaments
          GET
        • Create a tournament
          POST
        • Get a tournament
          GET
        • Update a tournament
          PUT
        • Delete a tournament
          DELETE
        • Process check-in results for a tournament
          POST
        • Abort check-in for a tournament
          POST
        • Start a tournament
          POST
        • Finalize a tournament
          POST
        • Reset a tournament
          POST
        • Open for predictions
          POST
      • Participants
        • List a tournament's participants
        • Create a participant
        • Bulk create participants
        • Get a participant
        • Update a participant
        • Check in a participant
        • Undo check-in for a participant
        • Delete/deactivate a participant
        • Clear/delete all participants
        • Randomize a tournament's participants
      • Matches
        • List a tournament's matches
        • Get a match
        • Update a match
        • Reopen a match
        • Mark a match as underway
        • Unmark a match as underway
      • Match Attachments
        • List a match's attachments
        • Create a match attachment
        • Get a match attachment
        • Update a match attachment
        • Delete a match attachment
  1. Tournaments

Create a tournament

Deprecated
POST
/tournaments.json
Create a new tournament.

Request

Authorization
API Key
Add parameter in query
api_key
Example:
api_key: ********************
or
Query Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://api.challonge.com/v1/tournaments.json?tournament[name]=&tournament[tournament_type]=&tournament[url]=&tournament[subdomain]=&tournament[description]=&tournament[open_signup]=&tournament[hold_third_place_match]=&tournament[pts_for_match_win]=&tournament[pts_for_match_tie]=&tournament[pts_for_game_win]=&tournament[pts_for_game_tie]=&tournament[pts_for_bye]=&tournament[swiss_rounds]=&tournament[ranked_by]=&tournament[rr_pts_for_match_win]=&tournament[rr_pts_for_match_tie]=&tournament[rr_pts_for_game_win]=&tournament[rr_pts_for_game_tie]=&tournament[accept_attachments]=&tournament[hide_forum]=&tournament[show_rounds]=&tournament[private]=&tournament[notify_users_when_matches_open]=&tournament[notify_users_when_the_tournament_ends]=&tournament[sequential_pairings]=&tournament[signup_cap]=&tournament[start_at]=&tournament[check_in_duration]=&tournament[grand_finals_modifier]=&api_key=<api-key>'
Response Response Example
{
  "tournament": {
    "accept_attachments": false,
    "allow_participant_match_reporting": true,
    "anonymous_voting": false,
    "category": null,
    "check_in_duration": null,
    "completed_at": null,
    "created_at": "2015-01-19T16:47:30-05:00",
    "created_by_api": false,
    "credit_capped": false,
    "description": "",
    "game_id": 600,
    "group_stages_enabled": false,
    "hide_forum": false,
    "hide_seeds": false,
    "hold_third_place_match": false,
    "id": 1086875,
    "max_predictions_per_user": 1,
    "name": "Sample Tournament 1",
    "notify_users_when_matches_open": true,
    "notify_users_when_the_tournament_ends": true,
    "open_signup": false,
    "participants_count": 4,
    "prediction_method": 0,
    "predictions_opened_at": null,
    "private": false,
    "progress_meter": 0,
    "pts_for_bye": "1.0",
    "pts_for_game_tie": "0.0",
    "pts_for_game_win": "0.0",
    "pts_for_match_tie": "0.5",
    "pts_for_match_win": "1.0",
    "quick_advance": false,
    "ranked_by": "match wins",
    "require_score_agreement": false,
    "rr_pts_for_game_tie": "0.0",
    "rr_pts_for_game_win": "0.0",
    "rr_pts_for_match_tie": "0.5",
    "rr_pts_for_match_win": "1.0",
    "sequential_pairings": false,
    "show_rounds": true,
    "signup_cap": null,
    "start_at": null,
    "started_at": null,
    "started_checking_in_at": null,
    "state": "pending",
    "swiss_rounds": 0,
    "teams": false,
    "tie_breaks": [
      "match wins vs tied",
      "game wins",
      "points scored"
    ],
    "tournament_type": "single elimination",
    "updated_at": "2015-01-19T16:57:17-05:00",
    "url": "sample_tournament_1",
    "description_source": "",
    "subdomain": null,
    "full_challonge_url": "http://challonge.com/sample_tournament_1",
    "live_image_url": "http://images.challonge.com/sample_tournament_1.png",
    "sign_up_url": null,
    "review_before_finalizing": true,
    "accepting_predictions": false,
    "participants_locked": true,
    "game_name": "Table Tennis",
    "participants_swappable": false,
    "team_convertable": false,
    "group_stages_were_started": false
  }
}
Modified at 2025-11-05 17:18:44
Previous
List tournaments
Next
Get a tournament
Built with