Bulk Create Participants

POST

/tournaments/{tournament_id}/participants/bulk_add.json

Bulk Creates a Participant

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

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

Path Params

Query Params

Header Params

Body Params application/vnd.api+jsonRequired

Examples

Responses

🟢200OK

application/json

Participant Response

Body

🟠400Bad Request

🟠401Unauthorized

🟠406Not Acceptable

🟠415Unsupported Media Type

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.challonge.com/v2.1/tournaments//participants/bulk_add.json?community_id' \
--header 'Accept;' \
--header 'Authorization-Type;' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "type": "Participants",
        "attributes": {
            "participants": [
                {
                    "name": "AllBossFights",
                    "seed": 1,
                    "misc": "",
                    "email": "me@allbossfights.xyz",
                    "username": "AllBossFights"
                }
            ]
        }
    }
}'

Response Example

200 - Example 1

[
    {
        "id": "76",
        "type": "participant",
        "attributes": {
            "name": "Player 1's Name",
            "seed": 1,
            "group_id": "(If this is a group stage match, there will be a group id here.)",
            "tournament_id": 21,
            "username": "(The participant's associated Challonge username, if present.)",
            "final_rank": 1,
            "states": {
                "active": true
            },
            "misc": "Store whatever string you like here",
            "timestamps": {
                "created_at": "2023-04-21T14:29:06.374Z",
                "updated_at": "2023-04-21T14:31:45.981Z"
            }
        }
    }
]

Modified at 2025-11-04 17:46:54

Delete Participant

Clear All Participants