Overview
This is a one-way sync. Information is pulled from GotSport to PlayerFirst, but in no instance will any information go from PlayerFirst to GotSport
The API will look for and sync over new athletes to a program once a day.
Adding your Brand's GotSport API Credentials in Site Settings
Sign in to a PlayerFirst website.
On the left navigation, click Site Settings > Site Settings.
Under the Teams & Schedules tab, Find the API Integrations header.
Enter your brand's GotSport Username, GotSport Password, and GotSport Org ID and their respective fields.
Click Save Settings at the top of the page.
Adding an Event's GotSport Event ID to a Program
NOTE: To find your event's GotSport Event ID, go to your event on GotSport. The ID will be listed in the URL.
Sign in to a PlayerFirst website.
On the left navigation, click Program > Registration Details.
Find the program you want to edit and click the Pencil icon on its row.
Navigate to the Reporting tab for the program.
Enter the GotSport Event ID in the respective field, then click the Save button next to the field.
After the page refreshes, you will see two buttons under the GotSport Event ID field; Import Rosters from GotSport and Import Schedule from GotSport.
DO NOT press either of these buttons until the below steps are read, and you are sure the program is setup correctly in PlayerFirst to pull the information over.
Syncing Rosters from GotSport
Before importing rosters from GotSport, ensure all of the following is true:
Division Names in PlayerFirst match the Division Names in GotSport exactly.
If the division names do not match, or there are more divisions in GotSport than in PlayerFirst, add/edit the divisions in PlayerFirst.
Team Names in PlayerFirst match the Team Names in GotSport exactly.
How to Sync Rosters from GotSport
Sign in to a PlayerFirst website.
On the left navigation, click Program > Registration Details.
Find the program you want to edit and click the Pencil icon on its row.
Navigate to the Reporting tab for the program.
Under the GotSport header, ensure that the GotSport Event ID is entered.
Click the Import Rosters from GotSport button.
After the button is clicked, two modals will display.
The API will look for and sync over new athletes to a program once a day.
To ensure rosters are automatically synced for the program, enable the Automatic Roster Sync field, then click Save.
Managing Athletes who were not Synced due to a Shared Email
After syncing, a banner will display on the Team Management page, stating if athletes were skipped during the sync. Any non-coach athlete whose athlete email or parent email is shared by 3 or more athletes on that same GotSport team is skipped rather than imported.
Show button: Opens a modal titled "GotSport Rosters Sync Skipped Athletes" listing the affected teams, the shared email, the athlete count and the athlete names.
Export button: Downloads a CSV (gotsport-shared-email-skips.csv).
NOTE: To avoid creating duplicate or incorrect accounts, the roster sync skips any athlete whose email (athlete or parent) is shared by 3 or more athletes on the same GotSport team. If athletes were skipped, a warning appears at the top of Team > Team Management. Click Show to see the team, shared email, and athlete names, or Export to download the list. Update the emails in GotSport and sync again.
Syncing Schedules from GotSport
How to Sync a Schedule from GotSport
Sign in to a PlayerFirst website.
On the left navigation, click Program > Registration Details.
Find the program you want to edit and click the Pencil icon on its row.
Navigate to the Reporting tab for the program.
Under the GotSport header, click the Import Schedule from GotSport button.
A confirmation message asks: "Are you sure you want to sync? Please double check your GotSport ID and make sure the entire tournament is finalized in GotSport before syncing." Confirm to continue.
A Results window opens, listing what was created — for example tournament, locations, fields, divisions, flights, teams, and games — and ending with "Sync Completed Successfully."
Click View Tournament to review the imported schedule.
If the sync doesn't work, the window shows "GotSport schedule sync failed:" followed by the reason. Double-check the GotSport Event ID and the credentials in Site Settings, then try again.
Keeping the Schedule Up to Date
The schedule import is a snapshot of the tournament as it stands when you run it. To keep scores and schedule changes coming in afterward, use the Incoming Updates checkbox, found next to the import button.
Incoming Updates — "Automatically sync scores and schedule changes from GotSport to PF." It turns on automatically when you save an Event ID.
While it's on, changes to the score, teams, field, and start/end time of games already in PlayerFirst are brought over, and a game that's deleted in GotSport is cancelled in PlayerFirst.
To turn it on or off, check or uncheck the box and click Save at the top of the page.
How to Enable Your Event to Display in the Access App
Log in to your PlayerFirst website.
On the dashboard, go to Schedule>Leagues & Tournaments page.
On the Leagues & Tournaments table, ensure that the event has a Green Checkmark in the Schedule Settings.
If the Event does not have the Green Checkmark, you just need to click the event name in the table to "activate" the event.
Once confirming the event is "activated" on the Leagues & Tournaments page, go to the Communication>Access App page.
On the Access App page, find your event and click the Pencil button.
On the App Settings page, change the Visibility setting to either Show During Event Dates or Custom Date Range.
Enable the Schedule in PlayerFirst field to ensure the schedule displays in the app.
