Table of Contents

Pointagram

Active with remarks
This application needs additional settings. Please follow the documentation below to create your own connectionUnique, active service acces point to a network. There are different types of connections (API key, Oauth…). More.

Pointagram

The Pointagram modulesThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More enable you to monitor, list, create, update, or add players to the team in your Pointagram account.

Getting Started with Pointagram

Prerequisites

A Pointagram account

In order to use Pointagram with Boost.spaceCentralization and synchronization platform, where you can organize and manage your data. More IntegratorPart of the Boost.space system, where you can create your connections and automate your processes. More, it is necessary to have a Pointagram account. If you do not have one, you can create a Pointagram account at Pointagram.

Note

The moduleThe module is an application or tool within the Boost.space system. The entire system is built on this concept of modularity. (module - Contacts) More dialog fields that are displayed in bold (in the Boost.space Integrator scenarioA specific connection between applications in which data can be transferred. Two types of scenarios: active/inactive. More, not in this documentation article) are mandatory!

Connecting Pointagram to Boost.space Integrator

To connect your Pointagram account to Boost.space Integrator you need to obtain the API Key from your Pointagram account.

Log in to your Pointagram account.
Click on your profile icon on the top of the page and open Settings.
Go to Integrations and enter your password to log in.
Select the Custom option to add a new custom integration and click on the Create Credentials button.
Click the Show Key button and copy the provided Authentication key.
Go to Boost.space Integrator and open the Pointagram module’s Create a connection dialog.
Enter your email address to the Login field and the API Key you have copied in step 5 to the respective field and click the Continue button to establish the connection.

The connection has been established. You can proceed with setting up the module.

Player

List Players

Searches for players by name, email or external ID.

Connection	Establish a connection to your Pointagram account.
Filter	Enter the search term (depends on the option selected in the Search by field below).
Search by	Select whether you want to search by player’s name, email or external ID.
Limit	Set the maximum number of players Boost.space Integrator will return during one execution cycleA cycle is the operation and commit/rollback phases of scenario execution. A scenario may have one or more cycles (one is the default)..

Create a Player

Creates a new player.

Connection	Establish a connection to your Pointagram account.
Player Name	Enter the name of the player in Pointagram.
Player Email	Enter the email address of the player. Used for sending invitation.
Player External ID	Enter the ID you can provide as a unique identifier for the player.
Player StatusCreate statuses for each module separately to create an ideal environment for efficient and consistent work. More	Select whether the new player is online or offline. An online player will receive an invitation to log on to Pointagram. Note, you can create players as offline players and convert them later in Pointagram.

Update a Player

Updates the name or email of an existing player.

Connection	Establish a connection to your Pointagram account.
Player Name	Enter the external ID of the player you want to update.
New Player Name	Enter the new name of the player.
New Player Email	Enter the new email address of the player.

Add a Player to a Team

Adds a player to a team in Pointagram.

Connection	Establish a connection to your Pointagram account.
Player Name	Select the player or map the ID of the player you want to add to a team.
Team Name	Select the team or map the ID of the team you want to add the player to.

Delete a Player from a Team

Removes a player from a team.

Connection	Establish a connection to your Pointagram account.
Team	Select the team or map the ID of the team you want to remove the player from.
Player Name	Select the player or map the ID of the player you want to remove from the team.

Watch Players

Retrieves player details when a new player is created.

Connection	Establish a connection to your Pointagram account.
Limit	Set the maximum number of players Boost.space Integrator will return during one execution cycle.

Points

Add Points

Adds points to the player in the score series.

Connection	Establish a connection to your Pointagram account.
Player	Select or map the ID of the player you want to add points to.
Points	Enter the number of points you want to add.
Scoreserie Name	Select the score series you want to add points to.

Make an API Call

Allows you to perform a custom API call.

Connection

Establish a connection to your Pointagram account.

URL

Enter a path relative to https://app.pointagram.com/server/externalapi.php

E.g. /list_players.

	Note
	For the list of available endpoints, refer to the Pointagram Custom API documentation.

Method

Select the HTTP method you want to use:

GET

to retrieve information for an entry.

POST

to create a new entry.

PUT

to update/replace an existing entry.

PATCH

to make a partial entry update.

DELETE

to delete an entry.

Headers

Enter the desired request headers. You don’t have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

Example of Use – List Players

The following API call returns all players in your Pointagram account:

URL:

/list_players

Method:

GET

The result can be found in the module’s Output under BundleA bundle is a chunk of data and the basic unit for use with modules. A bundle consists of items, similar to how a bag may contain separate, individual items. More > Body.

In our example, 2 players were returned: