Advertisement
Advertisement

Check out Challonge Connect, our new Tournament API Devkit for your Game, Website, or App.

Learn More ×

Bulk create participants

Advertisement

Bulk add participants to a tournament (up until it is started). If an invalid participant is detected, bulk participant creation will halt and any previously added participants (from this API request) will be rolled back.


URL

POST https://api.challonge.com/v1/tournaments/{tournament}/participants/bulk_add.{json|xml}

Parameters

Name Description
Gerekli
api_key
Your API key (required unless you're using HTTP basic authentication)
Gerekli
{tournament} (in URL string)
Tournament ID (e.g. 10230) or URL (e.g. 'single_elim' for challonge.com/single_elim). If assigned to a subdomain, URL format must be :subdomain-:tournament_url (e.g. 'test-mytourney' for test.challonge.com/mytourney)
participants[][name] The name displayed in the bracket/schedule - not required if email or challonge_username is provided. Must be unique per tournament.
participants[][invite_name_or_email] Username can be provided if the participant has a Challonge account. Providing email will first search for a matching Challonge account. If one is found, the user will be invited. If not, the "new-user-email" attribute will be set, and the user will be invited via email to create an account.
participants[][seed] integer - The participant's new seed. Must be between 1 and the current number of participants (including the new record). Overwriting an existing seed will automatically bump other participants as you would expect.
participants[][misc] string - Max: 255 characters. Multi-purpose field that is only visible via the API and handy for site integration (e.g. key to your users table)