Tools

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 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.

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 Score Series

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

Manage Team Membership

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

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 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.

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.

List Competitions

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

List Teams

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

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.

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.

Get Player

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