Developers

A gamification API built for developers

Most gamification tools hand you a closed widget. Playgent gives you an API. Generate content from a topic, URL, or text, configure games and players, read leaderboards, and receive a signed game.completed webhook on every play. Predictable JSON, HMAC-SHA256 on every event, no SDK required.

Scoped API keys

Per-key permissions for content read and write, games read, and players write. Issue a key per surface and rotate without downtime.

AI from topic, URL, or text

The same engine the Hub uses. Generate a puzzle from a topic, a page, or pasted text, auto-published to the edge on every call.

Signed webhooks

A signed game.completed event on every play. HMAC-SHA256 over body and timestamp, three retries with exponential backoff, a stable event_id for idempotency.

Audit log on every write

Every create, update, and webhook delivery is recorded, so the reward conversation is always backed by a trail.

Generate content in one call

The same engine the Hub uses. The response includes a preview URL, ready to embed.

curl https://api.playgent.com/api/v2/content \
  -H "Authorization: Bearer pg_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "game_type":  "trivia",
    "input_type": "topic",
    "input":      "Roman emperors",
    "language":   "en"
  }'

What the API covers

  • Content: generate and list puzzles from a topic, URL, or text
  • Games: read the catalog and per-game parameters
  • Players: create and manage the opaque user IDs you send us
  • Leaderboards: read scores per game and player
  • Webhook: signed game.completed delivered to your server

FAQ

Do I need an SDK?

No. The API is plain REST with predictable JSON. Drop the embed snippet for the player, and call the API directly from your server for everything else.

How are completion events secured?

Every game.completed webhook is signed with HMAC-SHA256 over the body and timestamp, with a stable event_id so you can dedupe. Treat the webhook as the source of truth, never the client callback alone.

What can I generate from the API?

Puzzles and content from a topic, a URL, or pasted text, across the catalog of game types and in 24 languages. Generated content auto-publishes to the edge.

Build whatever you need

Free Sandbox keys with the full catalog. Ship a working integration before you commit to a plan.