This feature is currently in Beta, meaning it is actively being tested and refined before a full release. It is not available to all organizations. Access is limited to clubs in CourtReserve's Early Access Groups. To request access, contact our Customer Success team via live chat or email.
INTRODUCTION
Feature Summary: The Pickleheads integration allows CourtReserve organizations to sync pickleball league events directly with the Pickleheads platform. Admins can designate events in CourtReserve as Pickleheads events, automatically sending event and registrant data to Pickleheads.
Players link their Pickleheads account once and can then register for Pickleheads events directly through the CourtReserve member portal or mobile app.
Currently, the integration supports leagues only (tournaments are not supported), and admins will select the pickleball format type within Pickleheads after syncing the event.
Use Cases:
Designate CourtReserve events as Pickleheads events to sync player and event data between both platforms
Allow players to link their Pickleheads account through the CourtReserve member portal / mobile app or during event registration
Manually or automatically sync event changes and registrant updates to Pickleheads in real time
Use CourtReserve's event management tools while leveraging Pickleheads for league and competitive play management
What Is Pickleheads?
Pickleheads is a dedicated pickleball platform that allows clubs and facilities to create, manage, and run pickleball leagues and events directly within their ecosystem. With features built specifically for pickleball — including league scheduling, player matchmaking, and event management — Pickleheads gives facilities a purpose-built tool for running competitive play. To learn more, visit pickleheads.com or explore their league management guide.
Introduction
Connect your CourtReserve account with Pickleheads to easily sync players and events between both platforms. With the integration enabled, admins can designate events in CourtReserve as Pickleheads events, automatically syncing registrant data to Pickleheads.
Players must link their Pickleheads account to their CourtReserve account before registering for a Pickleheads event. If they haven’t linked an account, they’ll be prompted to create one during the registration process in CourtReserve.
Prerequisites
This integration is available to all clubs with active CourtReserve subscription plans.
Before setting up the Pickleheads integration, you will need to generate a Secret Key from your Pickleheads account. This key is created during the integration setup process on the Pickleheads side and must be copied before completing setup — once you finish the setup flow, the key will no longer be accessible. To get started, review the steps in the next section.
If you need additional help, contact Pickleheads directly at [email protected] and a team member will assist you.
Finding Your Secret Key in Pickleheads
Go to pickleheads.com and log in to your account in the upper right corner.
Navigate to Subscriptions.
Scroll down to the Facility Integrations section and click Add.
In the Location field, search for and select your facility.
Select CourtReserve as the Integration.
Enter your DUPR Club ID if it is not already populated.
Add email addresses for any Facility Managers - these are the staff members who will have access to sessions synced from Court Reserve to Pickleheads. Use the email addresses they use at your facility.
Click Submit.
On the Facility Integration page, click Copy next to the Secret Key. You will paste this into CourtReserve to finalize the integration setup.
Important: Copy your Secret Key before clicking Finish. Once you complete the setup, the key will no longer be visible.
Once you have copied your Secret Key, return to Court Reserve and follow the steps in the next section to paste it into the Pickleheads integration field and complete the connection.
Setting Up the Pickleheads Integration
Navigate to Settings on the sidebar.
Scroll to the bottom row under Additional Features.
Under Integrations, locate the Pickleheads Integration option, check to enable it, and click Setup.
After initial setup, a Pickleheads icon will be available in the Additional Features row.
Pickleheads Integration Setup Page
On the setup page, enter your Secret Key in the field provided. Once your Secret Key is saved, the integration will be active and Pickleheads event functionality will become available when creating or editing events in CourtReserve.
Setting Up a Pickleheads Event
Once the integration is enabled, admins can designate any event in CourtReserve as a Pickleheads event. This tells CourtReserve that the event needs to sync to Pickleheads and that players must have their Pickleheads account linked before registering.
Navigate to Events > List on the sidebar and open an existing event or create a new one.
Select the Additional Setup tab.
Check the Is Pickleheads Event checkbox to designate the event as a Pickleheads event.
Click Save.
Once the event is saved and synced to Pickleheads, a Pickleheads Event URL will appear on the Additional Setup tab. This URL links directly to the event inside the Pickleheads platform and can be copied using the Copy URL button.
Note: Once one or more occurrences of an event have been synced to Pickleheads, the Is Pickleheads Event checkbox cannot be unchecked. A tooltip will display the message: "Cannot disable Pickleheads because one or more occurrences have already been synced."
Syncing Events to Pickleheads
CourtReserve automatically syncs Pickleheads events on a hourly basis. This hourly sync runs at the start of each day and includes any events marked as “Is Pickleheads Event” that are within 7 days.
Admins can also manually trigger a sync at any time, including for events scheduled more than 7 days out. However, those events will not be included in the automatic hourly sync until they fall within the 7-day window.
Manually Sync an Event
Navigate the event via Events > Events List. From the event's Dates tab, expand the event date and click the Sync to Pickleheads button. This will immediately push the latest registrant and event data to Pickleheads.
Note: Any changes made to an event date — such as updating the start time, end time, or other details — will automatically trigger a sync to Pickleheads when saved.
Admin: Registering Players into a Pickleheads Event
Admins cannot successfully register a player into a Pickleheads event from the admin panel if the player has not yet linked their Pickleheads account to their CourtReserve account. If an admin attempts to register an unlinked player, the following error will appear:
Players must complete the account linking process themselves through the member portal before an admin can register them into a Pickleheads event.
Pickleheads Account Status on the Member Profile
When viewing a player's profile from the admin panel, admins can see whether the player's Pickleheads account is linked. If the account has not been linked, a notice will display informing the admin that linking must be completed by the player through the member portal.
Once the player's account is linked, their Pickleheads ID will be visible directly on their profile. If needed, admins can remove the link at any time using the Unlink button.
Player Perspective: Linking a Pickleheads Account
Players can link their Pickleheads account to their CourtReserve account in two ways:
Option 1 — Via My Profile:
The player will log in to the member portal or mobile app and navigate to the menu under their name.
The player selects My Profile > Personal Information.
The player scrolls down and clicks the Link Pickleheads Account button.
A pop-up will appear prompting the player to enter their Pickleheads login credentials to complete the linking process.
Once linked, the player's Pickleheads ID will be displayed on their Personal Information page. The player can unlink their account at any time from this same page. Note: If the player does not have a Pickleheads account, they will be guided through a brief signup flow during the linking process.
Option 2 — During Event Registration:
If a player attempts to register for a Pickleheads event without a linked account, they will see the following message on the registration page:
From this screen, the player can click Link Pickleheads Account to complete the linking process without leaving the registration flow. If the player does not have a Pickleheads account, they will be guided through a brief signup flow. Once linked, they can proceed with registration.
Player Perspective: Registering for a Pickleheads Event
Pickleheads events are identified on the CourtReserve member portal and mobile app event details page with a Pickleheads Event label and icon, making them easy to recognize.
Once registered, players who are linked to Pickleheads will see a confirmation that their registration has been synced. The event details page will also display a link to the Pickleheads event URL so players can navigate directly to the event within the Pickleheads platform.
Audit Log
All Pickleheads integration activity is tracked in the CourtReserve Audit Log, giving admins a full record of sync events, registrations, and account linking activity. To access the Audit Log, navigate to Settings > Additional Features > Pickleheads and click the Audit Log button in the top right corner of the page.
