Match Admin

Purpose

Match Admin is the door from your Payload CMS into the nooQ League admin app — a separate service (nooq-golf-league-app) that handles competition setup, fixture generation, score entry and knockout brackets. The Payload screen is a thin redirect; the real work happens in the league app.

When to use this

Setting up a new season.
Entering match scores after a fixture.
Drawing or progressing a knockout.
Editing teams or divisions for an existing competition.

How it works

Click Integrations > Match Admin in the Payload sidebar.
Payload checks that League Settings has nooQ League enabled and a league org name set.
You're redirected to https://nooq.golf:8443/org/{your-org-name}/ (or your environment's equivalent). The league app authenticates you via Zitadel — same login as Payload, no second sign-in.
The league app loads your org's dashboard: list of competitions, seasons and current fixtures.

If League Settings isn't configured you'll see a Configure Match Admin prompt with a link straight to League Settings.

What you can do in the league app

| Task | Where | |---|---| | Create or edit a season | Competition page → Seasons → New. See Seasons. | | Add or remove teams | Season → Teams. | | Generate league fixtures | Season → Fixtures → Auto-generate (round-robin). | | Draw a knockout | Season → Knockout → Draw. See Knockouts. | | Enter match results | Fixture → Submit Result. See Match reports. | | View live tables | Competition → Standings (also the public/embedded view). | | Webhook / scorecard ingest | Auto — n8n posts scorecards in; no admin action needed. |

Common tasks

Open Match Admin

Integrations > Match Admin.
Wait for the redirect (typically <1s).
The league app's URL bar shows /org/{your-org-name}/. Bookmark this URL if you use it often.

When the redirect doesn't fire

"Not configured" message → League Settings is missing the org name or has the feature toggle off.
Redirect goes to a 404 on the league side → the league org name is wrong (case-sensitive string match). Confirm with nooQ Support, then update League Settings.
"Authentication required" on the league side → your Zitadel session expired. Click sign-in in the league app; you'll return to the same page.

Gotchas

Match Admin is not where you embed results on your website. Use Embedding league results for that — Match Admin is for admins entering data, not editors building pages.
Two-way sync is one-way in practice. Data flows league app → Redis → public displays. Changes you make in Payload to a league results page don't propagate back into the league app.
Access control. Match Admin in Payload only renders the link for users with the match-admin role (or super-admin). If you can't see the sidebar item, ask a tenant admin to grant the role.
The league app runs in its own window. Closing the tab doesn't sign you out — you can come back to the bookmark any time within your Zitadel session.