In this article, we'll go through the steps to add players to your TeamGenius assessment from your SportsEngine account. Once you enable the integration, SportsEngine will automatically sync players as they register into your TeamGenius assessment. 


Note: Your organization needs to be on the updated SportsEngine hq version which most customers should be on. If you are running the legacy version of SportsEngine, see our help article here for steps on adding players from that version. If you are unsure, log into your SportsEngine account and see if the (hq) icon is in the top left corner. 



Step 1: Navigate to your organization's SportsEngine account

Log into your SportsEngine account here. Click on SportsEngine hq. 


Once you are in your organization's account, click on Settings in the left side navigation menu. Click on API Integrations. 



Step 2: Enable the integration in SportsEngine


Step 2A: From the API Integrations tab, under Application Client Access, click on the Get Started button. 



A new window will pop up titled New Client Access. You will need to complete the following fields:

  • App Name - Title this the name of your organization 
  • Website URL - This is your organization's website link
  • Redirect URI - Use the link below but change the number to your TeamGenius ID which can be found in the URL address bar when you are logged into  your TeamGenius. The number is in bold below.  https://app.teamgenius.com/o/123456/sportngin/authcode

Remember to click the Save button.



You should now see a new item under the Application Client Access section titled with your organization name. You'll also see the Client ID and Client Secret keys. Save these to your clipboard by clicking the "save to clipboard icon" to the right of the keys. 


Note: Keep these keys secured. These are confidential keys which is why they are blacked out in the screenshots below. We recommend keeping your Client Secret key somewhere secure externally since it cannot be reproduced. 



Step 2B: From the API integrations dashboard, click on the 3 dots to the right of the Client Secret key box. This will open up a new window to enable the webhooks so SportsEngine can sync players as they register over to TeamGenius. 



Click on the arrow next to Webhooks URL. You'll see a text box to input the webhooks URL. This will be a combo of the exact URL link text below with your TeamGenius ID number which can be found in the URL address bar when logged into your TeamGenius account. It's the same number used to create the Client ID and Client Secret keys. 


Input the URL text as follows but change the bold number to your TeamGenius ID number:

  • https://events.teamgenius.com/api/webhooks/sportsengine/123456



Step 3: Finalize the integration steps in TeamGenius

Log into your TeamGenius account here. Hover over the Settings tab in the top navigation menu. Click on API Registrations. 



Click the green button Create API Registration. 


Input the following fields:

  • Name - This is up to you. Some options are SE Integration, SE Sync, SportsEngine Connection, etc. 
  • Platform - Click the drop down menu and select SportsEngine. 
  • Site ID - Navigate to your SportsEngine account and reference the numbers in your site URL. This is found at the top of your webpage in the website link. Commonly it's a 6 digit number. 
  • Client ID - Navigate to your SportsEngine account and copy the Client ID number to your clipboard.
  • Client Secret - Navigate to your SportsEngine account and copy the Client Secret number to your clipboard. 


Remember to click the Save button at the bottom once all fiends have been entered. 



You should now see the SportsEngine connection in your list of API Registrations. 



Step 4: Add players from SportsEngine to your TeamGenius assessment


Navigate to your TeamGenius assessment. Click on Players in the left navigation menu then click on Add Players. 



Click on the Add Players from a SportsEngine Registration option. 



You will now see a list of your organization's open registrations. Click on the desired registration from the list. From there, click on the Import this Registration button. 


Note: You can navigate to the registration form by clicking the icon to the right of your registration form name (circled in the screenshot below). This can be helpful if you need to edit your registration form. Since your TeamGenius account is connected to your SportsEngine account, it bypasses the step of logging into SportsEngine again. 


This will bring you to the field mappings page where you can continue the process. See more details about field mapping in our article: Adding Players - Field Mappings 


Note: You do not have to map all of the fields from your SportsEngine registration into TeamGenius. You are able to unmap fields by clicking the "X" next to the column name. 



***Important: Once you click Use These Mappings to import the players, you'll see a Player Summary box. Under the name of your SportsEngine registration, you'll see a box to Automatically import future registrations. Check the box if you want the system to automatically pull in players as they register. If this box is unchecked, you'll need to trigger the import each time by repeating the import steps above. 



Please note:  The system only allows TeamGenius to import registration data that is entered by the person registering the player.  If you would like to upload other items in SportEngine like payment status, you'll need to export your registration information as a CSV file and import that file using our CSV player upload option 


Step 5 : Confirm registered players are automatically syncing to TeamGenius


Now that you've completed the import manually once, any new players who register in SportsEngine will sync into TeamGenius automatically. It takes roughly 1-2 minutes for a newly registered player to appear in TeamGenius. 


You can verify players are syncing over to TeamGenius on the Assessment Home page. You'll see a SE Linked Registration section which shows you a breakdown of players imported from SportsEngine. 

  • Total webhooks: Number of players who've synced over automatically after your initial import
  • This week: Number of players synced this week. 
  • Today: Number of players synced today.
  • Total players: Total players in the assessment including those who've been automatically synced and initially imported manually.



You can also reference the synced players by going to the Players tab and clicking Webhook History. If this new tab doesn't automatically appear for you, sign out and back into your account. 




Next Step: Player Check-In


Related articles: