SocialPoint's endpoints allow you to gather, update and push data on your existing APG Games to take attendee interaction to the next level.
Here are the most popular ways in which our customers use the endpoints:
Registering your players
If you want your players to bypass the registration process, make sure you have your API key handy and know what information you want to register them with.
Hot Tip: Registration is an essential step before even trying to set up an Auto-Login code, so make sure you register your players first.
Here's how you register your players using our API:
Make sure you communicate the login data requirements for your event to your Onboarding Specialist (Name, phone, email, etc.)
Use a POST request to enter your player's information into the APG player list. More on APG Player parameters here.
Log in to the backend (app.socialpoint.io) with your credentials and navigate to Participation Game > Players and double-check all of your players are there.
Auto-Registering your players (NEW)
Alternatively, you can have your players click on a single link to both register and log in to the game.
Click here to learn more about how to build your Auto-Register URL.
Auto-login to the APG Player App
Auto-Login works only when there are registered players on your game (see above). To Auto-login players, you want to make sure you're using a URL that includes all necessary variables:
URL: {{ player app url }}?email={{ email }}&pin={{ pin }}&embedCode={{ embedCode }}
Click here to learn more about how to build your Auto-login URL.
Auto-login to your APG Virtual Prize Wheel
If you are using a Virtual Prize Wheel to reward your registered players in APG and you want them to access without having to enter their information, you can use a URL template for this:
URL: {{ prize wheel embed link}}&email={{ email }}
The variables are:
Game data:
{{ embedCode }} - this code is found under your event settings.
Player data:
{{ email }} - your registered player's email
APG Virtual Prize Wheel Auto-Login Example:
In this URL, we're logging into an existing APG Virtual Prize Wheel with "testplayer@test.com" as the email address. A player with this email already exists in our APG, so the request will be completed without any issues.
Retrieving player data from an APG
This feature is used by organizations who want to transfer scores from SocialPoint into their platform for multiple uses: leaderboards, rewards, data-tracking, cross-platform challenges, etc.
Follow these steps to access our endpoint and gather participant data: