📝 Overview
SportNinja provides a one-way integration of all primary season data from Dash, including teams, players, rosters, and schedules, along with updates via a scheduled batch import and update process. SportNinja complements Dash by specializing in streamlining and enhancing the operational efficiency of your leagues, saving you time and money. SportNinja not only elevates the player experience but also significantly boosts engagement across all participant interactions.
🔑 Authorizations
Before getting started, confirm the following access levels are in place.
Click the arrow to learn more about authorizations
Click the arrow to learn more about authorizations
The user setting up the integration in Dash must have the API Key Management authorization.
The user setting up the integration in SportNinja must have Account Owner access.
🛠️ Setup
There are two parts to setting up the SportNinja integration: configuring your API key in Dash and completing the connection in SportNinja.
🔐 API Key Setup in Dash
Click the arrow to learn how to set up your API key in Dash
Click the arrow to learn how to set up your API key in Dash
Type API Keys in the top search bar and select it to navigate to that section.
Select the Create button. Enter a name for your API key, such as sportninja_integration_key.
⚠️ Important Note: Make sure to copy the values for the Key and Secret properties shown on this screen. You will need to enter these into SportNinja.
Scroll down to the permissions section and update the token permissions to match the screenshot below.
✍️ Note: SportNinja does not have permission to write to Dash. SportNinja can only read information related to syncing a season and the associated teams, players, and scheduled games.
🔗 SportNinja Connection Setup
⚠️ Important Note: You will need an active SportNinja account before completing these steps.
There are 3 steps to import your schedules into SportNinja.
1️⃣ Connect SportNinja with Dash
Click the arrow to learn how to connect SportNinja with Dash
Click the arrow to learn how to connect SportNinja with Dash
Using the API key and secret created in the 🔐 API Key Setup in Dash section above, copy both values to a safe location before proceeding.
In SportNinja, navigate to your account settings:
Profile -> Account Settings -> Integrations tab
Enter your API key and secret in the fields provided and save.
2️⃣ Select a Season to Import
Click the arrow to learn how to select a season to import
Click the arrow to learn how to select a season to import
In SportNinja, go to your Organization and select the Dash button in the top-right corner.
Select your season from the dropdown menu.
✍️ Note: If you do not see your seasons in the dropdown, contact [email protected] for assistance.
3️⃣ Review & Import
Click the arrow to learn how to review and confirm your import
Click the arrow to learn how to review and confirm your import
After selecting your season, an import summary will appear displaying the total number of games, teams, players, rosters, locations, and facilities included in the sync.
Review the summary to confirm the data is correct.
Check the box confirming you have reviewed the summary and wish to proceed.
Select Confirm Import to complete the sync, or Cancel Import to go back.
⚠️ Important Note: Importing season data will overwrite existing data if it already exists. This action is irreversible.
⚙️ Dash Setup
Follow these steps to display SportNinja data within the Customer Portal.
Click the arrow to learn how to configure SportNinja in Dash
Click the arrow to learn how to configure SportNinja in Dash
In the global search box, type Integrations & Add-ons and select it.
On the left side, select the Integrations tab. Locate the SportNinja tile and select Get Started.
Toggle on the Enable SportNinja feature. When prompted, enter the Organization ID provided by SportNinja.
Select Save Settings.
Navigate to the season you want to display and select a level to view. Select the Settings tab on the left side for that level.
Enter the SportNinja Schedule ID provided by SportNinja and select Save.
🧑💻 Customer Portal View
Once the integration is configured, customers can visit a team page in the Customer Portal to view schedule and standings data synced directly from SportNinja.
Click the arrow to learn more about the Customer Portal view
Click the arrow to learn more about the Customer Portal view
Below upcoming events on a team page, customers will see a Schedule section and a Standings section if the team is connected to SportNinja.
Selecting the Standings tab will display current standings for that team's league.
