Tools

List Score History

Retrieves the score transaction history for a specific score series. Supports filtering by tags, teams, players, and time range. Supports pagination using offset parameters.

Remove Player

Soft-deletes a player from Pointagram. The player is identified by name, email, or external ID. Admin users cannot be removed via the API. Full anonymization must be done within the Pointagram UI.

List Team Players

Lists the players belonging to a Pointagram team, including their profile IDs and names. Use this to inspect or verify team membership. Call list_teams to discover team IDs.

List Score Series

Retrieves all score series in your Pointagram account. Optionally fetches the point types configured for a specific score series.

Get Player

Retrieves one Pointagram player, including contact details, external ID, administrator status, and profile icon. Call list_players to discover player IDs.

Create Player

Creates a new player in Pointagram. Players can be created as online (receiving a login invitation) or offline (admin-managed). If a player with the same identity already exists, the API returns a conflict error.

List Competitions

Retrieves competitions from Pointagram. Can optionally filter by player or competition ID. Also supports fetching competition participants.

Manage Team Membership

Add or remove a player from a team. Identify the player by their Pointagram player ID, name, email, or external ID.

Create Team

Creates a new team in Pointagram. An icon is required and can be a built-in icon filename (e.g. Bears.png, Bulls.png, Sharks.png) or a custom icon previously uploaded through the Pointagram UI.

List Teams

Retrieves all teams in your Pointagram account, including their names, icons, and configuration.

Add Score

Adds points to a player in a specific score series. Identify the score series by ID or name, and the player by ID, name, email, or external ID. Supports tags, comments, backdating, point types, deduplication via source score ID, and auto-creation of players.

Update Player

Updates an existing Pointagram player by ID, including their name, email, external ID, and online/offline setting. Call list_players to discover player IDs. Provide at least one field to update.

List Players

Retrieves players in your Pointagram account, optionally searching by name, email, or external ID. Returns player details and IDs for player updates and team membership.