Introducing Points: The Lightweight Rewards Engine for Developer Platforms

The Engagement Gap

Most developer platforms have a cold start problem. You ship the core product, the docs are solid, but the community dashboard feels empty. Users sign up, run a single API call, and disappear. The missing ingredient is often a lightweight reward loop—think GitHub’s contribution graph, or the streak counter in Duolingo. These tiny nudges aren’t gimmicks; they’re the backbone of habit formation.

At Sapior, we’ve watched teams hack together their own points tables in Postgres, then fight the eventual consistency nightmare when they need to aggregate balances at scale. We built Points so you don’t have to.

What is Points?

Points is a developer‑first rewards engine. You define point types (like “kudos” or “build_minutes”), award them through a simple REST call, and query a user’s balance in real time. All the ledger logic, idempotency, and webhook events are handled for you. It’s the same infrastructure that powers loyalty programs inside platforms like Vercel and Linear—now available to every Sapior customer.

A developer‑first API

The entire surface area of Points fits on a single napkin:

`POST /points/types` – create a new point type

`POST /points/award` – give points to a user for a specific event

`GET /points/balance?user=...&type=...` – fetch the current balance

`GET /points/ledger` – paginate through historical awards

Every award is idempotent thanks to a client‑supplied `idempotency_key`. You can safely replay events from your message queue without double‑counting. This design pattern came directly from our early beta users, who were building on top of Webhooks and didn’t want to manage exactly‑once semantics themselves.

Built on Sapior’s infrastructure

Under the hood, Points leverages the same durable storage and event bus you already trust for Feature Flags and Webhooks. Balances are stored as snapshots and updated via a stream‑processing pipeline, so a query for a user’s balance never hits a hot partition. If you need to run leaderboards, we expose materialized views you can query with a single index‑optimized endpoint.

How it works

Let’s walk through a typical integration. Imagine you run a CI/CD platform and you want to reward users for successful deploys.

1. Create a point type

curl -X POST https://api.sapior.com/points/types \
  -H "Authorization: Bearer $SAPIOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "deploy_credits",
    "name": "Deploy Credits",
    "description": "Earned for every successful production deploy",
    "expires_in_seconds": 7776000
  }'

2. Award points on an event

When your deploy pipeline succeeds, fire off an award:

curl -X POST https://api.sapior.com/points/award \
  -H "Authorization: Bearer $SAPIOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user_24",
    "point_type": "deploy_credits",
    "amount": 10,
    "idempotency_key": "dep_789_user_24",
    "metadata": { "commit_sha": "abc123" }
  }'

3. Query the balance

Your frontend can fetch the balance without waiting for a cache rebuild:

curl "https://api.sapior.com/points/balance?user=user_24&type=deploy_credits" \
  -H "Authorization: Bearer $SAPIOR_TOKEN"

Real‑world patterns

During the alpha, we saw teams use Points for more than just gamification:

**Usage quotas** – A database tool awarded “query credits” that users spent per request, effectively turning Points into a metering layer.

**Community recognition** – An open‑source fork of a forum platform awarded “answer points” to power a StackOverflow‑like reputation system.

**Early‑access gating** – A startup required 500 “builder points” before enabling their preview environment, creating artificial scarcity that drove 3× more feedback submissions.

As Brian Balfour’s growth loops framework reminds us, the most defensible products turn user actions into a reinvestable resource. Points becomes that atomic unit of reinvestment.

Get started

Points is available today for all Sapior customers. The free tier includes 10,000 awards per month, with no credit card required. Whether you’re building a rewards program, a usage‑based billing prototype, or just want to make your dashboard feel a little more alive, we’d love to see what you build.

[Start with Points →](https://sapior.com/points)