Challonge API Docs
  1. Tournament
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
          GET
        • createTournament
          POST
        • showTournament
          GET
        • updateTournament
          PUT
        • deleteTournament
          DELETE
        • changeStateTournament
          PUT
      • 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
        • Create a tournament
        • Get a tournament
        • Update a tournament
        • Delete a tournament
        • Process check-in results for a tournament
        • Abort check-in for a tournament
        • Start a tournament
        • Finalize a tournament
        • Reset a tournament
        • Open for predictions
      • 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. Tournament

createTournament

Deprecated
POST
/tournaments.json
Creates a tournament

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
OAuth 2.0
Authorization Code
Add the parameter
Authorization
to Headers
,whose value is to concatenate the Token after the Bearer.
Example:
Authorization: Bearer ********************
Authorize URL: https://api.challonge.com/oauth/authorize
Token URL: https://api.challonge.com/oauth/token
or
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Header Params

Body Params application/vnd.api+jsonRequired

Examples

Responses

🟢201Created
application/json
Tournament Response
Body

🟠400Bad Request
🟠401Unauthorized
🟠406Not Acceptable
🟠415Unsupported Media Type
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.challonge.com/v2/tournaments.json' \
--header 'Accept;' \
--header 'Authorization-Type;' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "type": "Tournaments",
        "attributes": {
            "name": "Rainbow Six: Siege Tournament",
            "url": "r6siege_tournament_xx",
            "tournament_type": "single elimination",
            "private": true,
            "starts_at": "string",
            "description": "string",
            "notifications": {
                "upon_matches_open": true,
                "upon_tournament_ends": true
            },
            "match_options": {
                "third_place_match": true,
                "accept_attachments": false
            },
            "registration_options": {
                "open_signup": false,
                "signup_cap": 0,
                "check_in_duration": 0
            },
            "seeding_options": {
                "hide_seeds": false,
                "sequential_pairings": false
            },
            "double_elimination_options": {
                "split_participants": false,
                "grand_finals_modifier": ""
            },
            "round_robin_options": {
                "iterations": 2,
                "ranking": "",
                "pts_for_game_win": 1,
                "pts_for_game_tie": 0,
                "pts_for_match_win": 1,
                "pts_for_match_tie": 0.5
            },
            "swiss_options": {
                "rounds": 2,
                "pts_for_game_win": 1,
                "pts_for_game_tie": 0,
                "pts_for_match_win": 1,
                "pts_for_match_tie": 0.5
            },
            "free_for_all_options": {
                "max_participants": 4
            }
        }
    }
}'
Response Response Example
201 - Example 1
{
    "id": "r6_siege_tournament_xx",
    "type": "tournament",
    "attributes": {
        "name": "Rainbow Six: Siege Tournament",
        "url": "r6siege_tournament_xx",
        "tournament_type": "single elimination",
        "private": true,
        "starts_at": "string",
        "description": "string",
        "notifications": {
            "upon_matches_open": true,
            "upon_tournament_ends": true
        },
        "match_options": {
            "third_place_match": true,
            "accept_attachments": false
        },
        "registration_options": {
            "open_signup": false,
            "signup_cap": 0,
            "check_in_duration": 0
        },
        "seeding_options": {
            "hide_seeds": false,
            "sequential_pairings": false
        },
        "double_elimination_options": {
            "split_participants": false,
            "grand_finals_modifier": ""
        },
        "round_robin_options": {
            "iterations": 2,
            "ranking": "",
            "pts_for_game_win": 1,
            "pts_for_game_tie": 0,
            "pts_for_match_win": 1,
            "pts_for_match_tie": 0.5
        },
        "swiss_options": {
            "rounds": 2,
            "pts_for_game_win": 1,
            "pts_for_game_tie": 0,
            "pts_for_match_win": 1,
            "pts_for_match_tie": 0.5
        },
        "free_for_all_options": {
            "max_participants": 4
        }
    }
}
Modified at 2025-11-05 15:57:46
Previous
findTournaments
Next
showTournament
Built with