Skip to main content
Pointagram logo
  • Category: productivity
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 8
  • Triggers: 0
  • Slug: POINTAGRAM
  • Version: 20261101_00

Tools

Slug: POINTAGRAM_ADD_SCOREAdd points to a Pointagram player in a score series, optionally including tags, a description, and automatic player creation. Reusing a source score ID can revoke the previous transaction and replace it.

Input Parameters

array
Tags displayed with points. Each tag should have a ‘name’ field.
integer
Number of points to award. Use this OR pointtype_name.
string
Description visible in the news feed about this score entry.
string
Internal Pointagram player identifier. Use this if you have the player’s ID.
string
Sets transaction timestamp in datetime format (e.g., ISO 8601).
string
Player’s display name for identification. Use when player_id is not available.
string
Player’s email address for identification. Use when player_id is not available.
integer
Set to 1 to automatically create missing players. Leave unset or set to 0 to not create players.
string
Named point type to assign. Use this OR points.
string
ID of the target score series. Use this OR scoreseries_name.
string
Transaction identifier. Reusing this ID will revoke the previous entry with the same ID.
string
Name of the target score series. Use this OR scoreseries_id.
string
Your system’s unique player identifier. Use for integration with external systems.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POINTAGRAM_LIST_COMPETITION_PLAYERSTool to fetch competition players and standings in Pointagram. Returns detailed player rankings, scores, and competition participation data. Use when you need to retrieve player standings, competition leaderboards, or analyze player performance across competitions.

Input Parameters

string
Filter by specific player ID to get their competition participation.
string
Filter players by specific competition ID. If not provided, returns players from all competitions.
string
Filter by external player identifier from your system.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POINTAGRAM_LIST_COMPETITIONSTool to fetch competitions in Pointagram with optional filtering. Use when you need to retrieve competition information including rankings and scores. Supports filtering by player (email, name, external ID), competition ID, or access key.

Input Parameters

string
The search value to match against the criteria specified in search_by parameter. Used to filter competitions by player information.
string
Filter results to show only competitions associated with a specific access key identifier.
string ("Email" | "Name" | "External Id")
Specifies the search criteria type to filter competitions by player. Accepts ‘Email’, ‘Name’, or ‘External Id’. Used in combination with ‘filter’ parameter.
string
Filter results to show only a specific competition by its unique ID. When provided, returns data for a single competition.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POINTAGRAM_LIST_PLAYERSFetch players in Pointagram, optionally filtering by email, name, or external ID. Returns player names, email addresses, and identifiers.

Input Parameters

string
The search value to match against the specified search_by field. Used in combination with ‘search_by’ parameter to filter results.
string ("Email" | "Name" | "External Id")
Specifies the search field to filter players. Accepts ‘Email’, ‘Name’, or ‘External Id’. If provided, ‘filter’ parameter must also be provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POINTAGRAM_LIST_SCORE_SERIESTool to list all score series in Pointagram. Use when you need to retrieve all configured score series collections that track and measure different point types.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POINTAGRAM_LIST_SCORE_SERIES_HISTORYFetch a page of historical point transactions for a score series, with optional filters for tags, teams, players, and time range. Use the timestamp and ID offsets to retrieve further pages.

Input Parameters

integer
Maximum rows per request (default: 50, maximum: 1000).
string
End time in UTC format “YYYY-MM-DD HH:MM:SS”.
string
For pagination - use previous response’s last row ID. Must be used together with offset_timestamp.
string
Start time in UTC format “YYYY-MM-DD HH:MM:SS”.
string
Filter by specific tags in JSON format: [{“id”:“13”,“type”:1},{“id”:“14”,“type”:1}] where type 1=tags, type 2=point type.
integer
Set to 1 to include revoked points; default is 0.
string
Filter by team IDs in JSON format: [“20”].
string
Filter by player profile IDs in JSON format: [“19145”].
integer
required
The ID of the score series to fetch history for. This is a required parameter.
string
Alternative tag filtering with OR logic. Same format as tags_filter: [{“id”:“13”,“type”:1}].
string
For pagination - use previous response’s last row timestamp. Must be used together with offset_id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POINTAGRAM_LIST_SCORE_SERIES_POINT_TYPESTool to fetch point types for a specific score series in Pointagram. Use when you need to retrieve the different types of points that can be awarded within a score series.

Input Parameters

integer
required
Id of the score series to fetch Point Types for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: POINTAGRAM_LIST_TEAMSTool to fetch and list all teams in Pointagram. Returns team information including ID, name, and icon. Use when you need to retrieve all available teams.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not