| name | No | Defaults to '<Sport> tournament 14 Aug 2026 (<location>)' — start date (or today) plus the location when known | |
| pairs | No | Doubles: fixed pairs as [name, name] arrays. Omit to auto-pair. | |
| sport | Yes | Write sport names to the organiser in words — 'table tennis', never the enum spelling 'table_tennis'. | |
| courts | No | Default 2 | |
| format | No | Tournament format. round_robin: everyone plays everyone. groups_playoff: round-robin groups then a knockout. single_elimination: knockout with byes. americano/mexicano: rotating-partner doubles, points per round (mexicano pairs each round from standings). OMIT when the organiser hasn't clearly chosen — the call then returns a menu of explained options to show them instead of creating anything. | |
| rounds | No | Americano/mexicano; default from player count | |
| players | No | | |
| seeding | No | Default random | |
| language | No | Language of the tournament page, PDFs and player emails (ISO 639-1). Default en; set it to the language the organiser is writing in when it is in this list. | |
| location | No | Venue/location shown to players on the page, e.g. club name + city | |
| discipline | No | Ask the organiser — never infer it from the sport. Americano/mexicano are always doubles. Defaults to singles for the bracket formats when they truly have no preference. | |
| request_id | No | Optional idempotency id — retrying the call with the same id returns the same tournament and key instead of creating a second one. It doubles as the secret that guards that replay, so it must be at least 16 characters of your own random choosing (a UUID is ideal); short or predictable ids are refused before anything is created. | |
| signup_cap | No | Signup limit; beyond it players join a waitlist | |
| start_time | No | ISO datetime with offset, e.g. 2026-08-01T18:00:00+03:00. Must be within 365 days from today. | |
| court_names | No | | |
| group_count | No | | |
| house_rules | No | Organiser's house rules, shown on the tournament page (e.g. 'Golden point at deuce') | |
| level_scale | No | How to read the numbers in `level`. absolute (default): one shared scale, a 3 is a 3 whoever holds it. by_group: men and women were each rated within their own group, so the numbers are not directly comparable — ask the organiser which they did rather than guessing. ignore: the numbers are notes, never used for the draw. | |
| signup_open | No | Open self-signup: players add themselves on the shared page (name-only or signed in). Offer this when the organiser has no player list yet. | |
| level_offset | No | by_group only: how much stronger an m is than an f carrying the SAME number, in the organiser's own level units. Default 1 — a starting point to adjust, not a fact. Used for balancing only; never shown on the page or in standings. | |
| break_minutes | No | Changeover between matches/rounds, shown separately from play time (default 0) | |
| level_gap_cap | No | Opt-in: the largest level gap the organiser wants between opponents, in their own level units. Soft — the draw prefers to respect it and reports when it cannot. Pass 0 to clear. | |
| gender_balance | No | Americano/mexicano: prefer matches where both teams have the same make-up (MM v MM, MW v MW, WW v WW). Default prefer_symmetric. A preference, not a rule — an uneven field cannot supply it, and the draw says so rather than distorting the rotation. | |
| points_per_match | No | Americano/mexicano; default 21 | |
| advance_per_group | No | | |
| third_place_match | No | Single elimination; default true | |
| page_results_entry | No | Allow anyone with the page link to enter scores courtside. Default TRUE — recreational tournaments run on whoever finishes their match first, and an organiser who has to type every result is the bottleneck. Pass false if the organiser wants to be the only one recording scores; switchable either way at any time via update_settings or the toggle on the page. | |
| match_duration_minutes | No | | |
