ceven

Pointagram

Tracks team achievements and awards points based on external triggers, updates leaderboards in real time, and generates performance reports for management.

Try Pointagram in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Pointagram integration

    • Describe the outcome and Ceven picks the right Pointagram calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Pointagram data, across all 8 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Pointagram access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Pointagram, when, and on whose behalf.
    • The agent pauses and asks when Pointagram is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Pointagram.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Pointagram action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Pointagram, and when to use it.

Add Score
Use this when you need to award points to players in a score series, including optional tags, descriptions, and automatic player creation if they do not exist.
List Competition Players
Pull detailed player rankings, scores, and participation data for a specific competition to determine current standings.
List Competitions
Retrieve a list of all competitions, optionally filtering by player email or name to see where specific people stand.
List Players
Pull player information including name, email, external ID, and status, with optional filtering by name or email.
List Score Series
Retrieve all configured score series collections to identify which point types are available for tracking.
List Score Series History
Pull historical point data for a score series, filtered by tags, teams, players, or time range to analyze trends.
List Score Series Point Types
Retrieve the specific types of points that can be awarded within a chosen score series to ensure correct tagging.
List Teams
Pull a list of all available teams including their unique IDs, names, and icons.

8 actions · scroll to see them all

Frequently asked questions

When the agent uses the Add Score action, Pointagram allows for automatic player creation. If Ceven attempts to award points to an email address that does not currently exist in your Pointagram database, the system will automatically create a new player profile using the provided details. This means you do not need to manually import every single employee or contractor before you start running automated workflows. The agent simply passes the email and name, and Pointagram handles the provisioning in the background, ensuring that no achievement goes unrewarded due to a missing account record in the gamification platform.
Yes, you can configure workflows to subtract points by passing a negative integer through the Add Score action. For example, if a critical deadline is missed in your project management tool, Ceven can trigger a point deduction in Pointagram to reflect that outcome. However, you should be mindful of your internal culture and how negative reinforcement is perceived. From a technical standpoint, the API treats negative values as deductions, which immediately updates the player standings and the score series history, allowing you to maintain a strictly accurate reflection of performance metrics in real time.
Pointagram employs a standard rate limiting policy to ensure platform stability. If you are running a massive bulk update, such as awarding points to thousands of players simultaneously after a company wide event, you may encounter 429 Too Many Requests errors. Ceven manages this by implementing an exponential backoff strategy, which means the agent will automatically pause and retry the request after a short delay. To avoid significant lag in your workflows, we recommend batching large updates or staggering the triggers over several minutes rather than firing thousands of individual API calls in a single second.
Currently, the integration focuses on the operational side of gamification, meaning it can read competitions and write scores, but it cannot create the high level structure of a new competition or define a new score series from scratch. You must first define your competitions, point types, and series within the Pointagram dashboard. Once those are established, Ceven can fully manage the data flow, awarding points to the right series and pulling rankings for reports. This ensures that your gamification strategy remains controlled by an administrator while the daily execution is handled by the AI agent.
Ceven primarily uses the email address as the unique identifier to link a user in your SaaS tools to their Pointagram profile. When a workflow is triggered by an event in a tool like Salesforce or Zendesk, the agent extracts the user email and queries Pointagram to find the matching player ID. If you use a different internal ID system, you can map those to the external ID field in Pointagram. This ensures that points are always credited to the correct individual, even if they have changed their display name or are part of multiple teams within the organization.
Yes, the List Score Series History action supports time range filtering. You can ask the agent to pull data for a specific week, month, or custom date range to analyze performance spikes. This is particularly useful for creating monthly MVP reports or analyzing the impact of a specific incentive program. The agent retrieves the time series data and can then summarize the findings, telling you who the most consistent performers were during that window or which specific point types were awarded most frequently, providing a clear view of team activity.
While the Pointagram API is designed to award points to individual players, Ceven handles team awards by first calling the List Players or List Teams action to retrieve all members of that group. The agent then iterates through the list and executes an Add Score call for each individual member. This creates the effect of a team wide award while maintaining the individual player records required by Pointagram. For very large teams, the agent will handle this as a background sequence to ensure that rate limits are not exceeded and that every team member receives their points.
Ceven connects to Pointagram using secure API authentication, ensuring that all data transmitted between the two platforms is encrypted. We follow the principle of least privilege, meaning the agent only accesses the specific endpoints required to execute your workflows. Your API keys are stored using industry standard encryption at rest and are never exposed to other users or the underlying large language model. You can rotate your API keys within the Pointagram dashboard at any time, which will immediately invalidate the previous connection and require a quick update in the Ceven integration settings.

Alternatives to Pointagram

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Spinify logoSpinifyAmbition logoAmbitionBonusly logoBonusly

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Pointagram and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free