Report club results from your own site or app. Share with the USTSO.
Already run events on your club website, in your own app, or in bracket software you
like? Send us the finished results and they become a real Foos App
tournament — full bracket, standings, and podium, shared with the USTSO
community on a public page and inside the app. One request. No SDK.
publish-results.sh
# validate first — always rolls back, nothing is saved
curl -X POST 'https://foos-api.com/api/v1/integrations/tournaments?dry_run=1' \
-H 'X-Club-Api-Key: •••••••••' \
-d @spring-open.json
{ "ok": true, "tournament": {
"name": "Spring Open 2026",
"match_count": 15,
"bracket_url": "https://www.foos-app.com/tournaments/812/bracket"
} }
Three steps, and one of them is us.
You do not need a developer. The spec was written to be read by an AI, so the
realistic version of this is: get a key, paste a prompt, check the result.
1
Get your API key
Verify your phone number and name — we'll take you straight to key
creation. Keys are scoped to your club; we store only a hash, so each
key is shown once and can be replaced but never recovered.
Point ChatGPT, Claude, Cursor, or whatever you use at the spec along with one
example export from your system. Everything it needs is in that one document —
the payload shape, every format, worked examples, and the failure modes.
Prompt to copy
Read https://www.foos-app.com/integrations.md — it is the full spec for the Foos App tournament import API. Then write a script that converts the attached export from our tournament software into a valid import payload, and dry-run it against our API key until it returns ok: true.
3
Dry run, then go live
Every import can be validated first. A dry run builds the whole tournament —
bracket, results, podium — inside a transaction that always rolls back, and
shows you exactly what would be created. Nothing is saved until you are happy
with it, and re-sending a corrected payload cleanly replaces the old one.
What your club gets.
A real bracket
Not a screenshot or a PDF. A live bracket page that people can open, share, and
scroll through match by match.
Players who keep their history
Results attach to real Foos App accounts where they exist, so your regulars build
a record that follows them everywhere.
Findable events
Your tournaments show up in the app and on the web with standings and a podium —
in front of players looking for a place to play.
Your history, backdated
Send an event from three years ago and it lands in the archive at the right date.
Bring the whole back catalogue.
The whole spec, one page.
Written for a machine to read. Plain text, no login, no key required.