Golf Genius Integration

Purpose

Pulls competitions and leaderboards from Golf Genius into your website. Once configured, your Events, Competition pages, and leaderboard blocks all update from Golf Genius on a schedule — no manual data entry.

When to use this

Your club uses Golf Genius for competition management and you want the website to mirror that data.

Key fields

API key — provided by Golf Genius support. Stored encrypted.
Club IDs — array of Golf Genius club IDs to sync. Most clubs have one; multi-course operators have several.
Course maps — links each Golf Genius course code to a nooQ Course record (used for handicap calcs and display names).
Filter config — which competition types to import (Member, Open, Society…) and which to skip.
Sync schedule — Hourly / Every 6h / Daily / Manual only.
Auto-publish competitions — whether synced events arrive as Draft or Published.
Block defaults — default colour scheme and field set for Golf Genius blocks on pages.

Common tasks

Initial setup

Ask Golf Genius support for an API key.
Integrations > Golf Genius, paste the API key.
Add your Club ID(s).
Save — the first sync runs in the background (5-30 minutes for a typical club).
Open the Course maps tab and match each Golf Genius course to a nooQ Course.

Show a leaderboard on a Page

Edit a Page > Add a Golf Genius Leaderboard block.
Pick the season, competition and round from the cascading dropdowns (synced competitions appear here).
Choose columns (Position, Name, Score, Through, To Par).
Save. The block refreshes every time the sync runs.

For the full step-by-step (with a short Loom walkthrough), see Add a Golf Genius leaderboard to a page.

Force a manual sync

Integrations > Golf Genius, click Sync now.
Wait for the toast confirmation.
Check Events to see new competitions land.

How the sync interacts with existing events

The sync never creates duplicates of events you already have. Per competition it pulls, it tries to match in this order:

Same Golf Genius ID — if a previous sync already imported this competition, the existing event is updated in place.
Cross-source match — same calendar day + same venue + ≥90% title similarity. If your manually-created or CSV-imported event matches, the sync merges into it and stamps the Golf Genius link on top.
No match — a new event is created.

What this means for you:

Rename or rewrite a synced competition in the admin — your edits stick through future syncs.
Add a richer description than what Golf Genius supplies — the longer description is kept.
Only three fields are owned by Golf Genius and refreshed every sync: External ID, External URL, and Source (these are how the "View on Golf Genius" link works).

See Events and Calendar — How duplicates are detected for the matching rules in full.

Gotchas

Venue must be set on a manual/CSV event for the GG sync to merge into it. An event with no venue can't be matched — Golf Genius will create a separate event instead.
Block v2 — there are two generations of Golf Genius blocks. New blocks (v2) handle more competition formats; use them by default. Older v1 blocks still work but are frozen.
Course maps are required for handicap-adjusted leaderboards to render. If a course is unmapped, you'll see raw gross scores only.
Don't expose the API key — it grants read access to all your competitions across clubs. The encrypted field is the only safe place.
Sync failures — if the supplier returns 5xx errors, the sync retries with backoff. Check the n8n workflow status if events stop arriving.