We use cookies (and other similar technologies) for many purposes, including to improve your experience on our site and for ads and analytics.

For developers & tinkerers

Any data source. One leaderboard.

BoardQ's REST API turns anything that can send a JSON POST — your CRM, your game server, your gym booking system, your AI agent — into a live, public scoreboard. Authenticate with a bearer token, push a score, and every screen connected to the board updates in real time.

🔌 REST API⚡ WebSocket real-time🤖 AI-agent friendly🆓 Free tier includes API access
BoardQ leaderboard on an office wall display, auto-updating live from API integration with a JSON data source
1
POST to get on the board
<1s
API call to live update
0
SDKs to install
$0
API on the free plan
Why use the API?

Stop manually updating leaderboards.

Spreadsheets fall behind. Manual entry is forgotten. Webhooks fire reliably. If your tool already knows when a score changed — deal closed, lap finished, WOD logged, event booked — let it tell the leaderboard directly.

One source of truth

Your CRM, your game engine, your booking system already holds the data. Pipe it straight in — no manual sync, no stale numbers, no human in the loop.

🔄

Real-time, every screen

One API call updates the office TV, the team Slack embed, the OBS overlay and every spectator's phone simultaneously. WebSocket-powered.

🤖

AI & agent ready

Any LLM workflow, GPT function call, or Claude tool use can POST scores. Use the board as the visual output layer for AI-judged competitions or agent-driven rankings.

Connect any source

If it speaks JSON, it speaks BoardQ.

The API takes a board ID, a participant name, and a score. Send a JSON POST from anywhere — your backend, your Zapier workflow, your AI agent, your CRM's native webhook. No SDK to install. No client library to version-pin. Just HTTP.

  • Bearer-token authentication via API key
  • JSON payloads — same shape from every source
  • Live updates pushed over WebSocket to all viewers
  • Works in any language that can make an HTTP call
See the full API reference →
BoardQ leaderboard auto-updating from a JSON data source with secure API, real-time sync and clean structured tables
Laptop showing a live BoardQ leaderboard connected via API with a JSON POST request and AI sync indicator
AI & LLM workflows

Give your AI agent a leaderboard to publish to.

LLM judges scoring outputs. Agents tracking content performance. GPT or Claude function calls grading support tickets, evaluating model runs, ranking submissions. The API is a standard HTTP endpoint — any AI workflow that can call a tool can write to a BoardQ board.

  • OpenAI function-calling & Claude tool-use ready
  • Evaluation harnesses can publish run leaderboards
  • Agentic workflows get a public visual output
  • Pair with structured JSON outputs end-to-end
Wire up an AI agent →
Webhooks & Zapier

No-code? Webhooks. No-webhook? Zapier.

Already pay for Zapier or Make? Pipe BoardQ into your existing automations in two clicks. Already have your own tool? Drop the BoardQ URL into your webhook field. The JSON shape is the same either way.

  • Zapier & Make compatible via Webhooks module
  • Native webhook support from Salesforce, HubSpot, Pipedrive
  • Trigger on form submissions (Typeform, Tally, Google Forms)
  • Donation platforms, event apps, smart equipment
See webhook examples →
BoardQ leaderboard on a wall display with API integration sidebar showing GET endpoint and system status: API connected, AI sync active, auto-update enabled
Works with

Pipe BoardQ into your existing stack.

Some integrations are one Zapier hop. Some are a native webhook. Some are a direct curl from your backend. None require us — or you — to build anything custom.

🤖

OpenAI & Claude

Function calls and tool use can POST directly. Publish evaluation runs, agent decisions, LLM judging output to a live board.

☁️

Salesforce

Fire a webhook on Opportunity Closed Won. Live revenue leaderboard on the sales floor TV without RevOps lifting a finger.

🧡

HubSpot

Workflow webhook on deal-stage change pushes the score. Sales team sees the leaderboard refresh between calls.

Zapier & Make

Webhooks module connects BoardQ to 6,000+ apps without writing code. Common starter for non-engineers.

💬

Discord & Slack

Bots (discord.js, discord.py, Slack apps) POST scores on chat events. Embed the board back into channels.

🎮

Unity / Unreal / Godot

Drop an HTTP request on game end. Ship a global high score table without standing up a backend.

📺

OBS / Streamlabs / vMix

Add the leaderboard URL as a browser source. Live overlay that updates with chat or stream events.

🏋️

Mindbody / Glofox

Pipe gym member scores via Zapier or direct webhook. Live class-vs-class boards on the gym TV.

The whole API

One endpoint. One request. You're done.

The fewer endpoints, the fewer surprises. Push a score with a single POST. Read a board with a single GET. Embed with an iframe. That's most of what most users ever need. Full reference in the docs for edge cases — auth scopes, rate limits, error shapes.

  • POST /v1/scores — write a single score to a board
  • POST /v1/scores/batch — bulk-write multiple scores at once
  • GET /v1/boards/{id} — fetch current standings
  • iframe /embed/{id} — drop the live board anywhere
Read the full API docs →
push-score.sh
# That's it. That's the whole integration.
curl -X POST https://api.boardq.io/v1/scores \
  -H "Authorization: Bearer $BOARDQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "board_id": "leaderboard",
    "participant": "Luna",
    "score": 322
  }'

# Response: 200 OK — board refreshed on every screen.
Developer experience

Boring API. Exciting boards.

🔑 Bearer-token auth

Generate API keys in your dashboard. Rotate when you need to. No OAuth dance required.

📦 JSON in, JSON out

Standard REST shapes. Same payload from your backend, your Zap, or your AI agent.

⚡ WebSocket push

Score writes propagate live to every connected viewer. No polling, no refresh.

📺 iframe embed

Drop a board into your website, intranet, OBS, Slack, Notion or Confluence with one snippet.

🤖 AI-agent friendly

OpenAI functions, Claude tools, agentic workflows — any JSON-emitting workflow plugs in.

🪝 Webhooks & Zapier

Compatible with every common automation tool. No-code pipelines welcomed.

📈 Batch writes

Bulk-import historical data or push many results at once with the /batch endpoint.

🌐 Public read access

Optionally expose your board's data for syndication, analytics, or third-party dashboards.

Works in any language

No SDK to install. HTTP is the SDK.

curlJavaScriptNode.jsPythonGoRubyPHPC#RustJavaKotlinSwift

“Wired BoardQ to our HubSpot Closed-Won webhook in about ten minutes. The sales floor now has a live revenue leaderboard that's never out of date — and RevOps never has to think about it again.”

RevOps Lead· B2B SaaS, 60 reps
FAQ

Developer questions.

How does the API work?

Standard REST. Bearer-token auth, JSON payloads, HTTP status codes. POST a score, the WebSocket pushes the update to every viewer. No SDK to install — any language that can make an HTTP request works.

What tools can I integrate with?

Anything that can send an HTTP POST. Salesforce, HubSpot, Pipedrive, Mindbody, Discord bots, OBS, Zapier, Make, Eventbrite, Typeform, custom game engines, AI agents, your own backend.

Is the API free?

Yes. API access is included on the free plan with reasonable rate limits. Premium ($6.99/month) raises limits and unlocks unlimited boards for production use.

Can an AI agent push scores?

Yes. The API is a standard REST endpoint, so any LLM workflow, GPT function call, or Claude tool use can submit scores. Useful for AI-judged competitions, eval harnesses, or agentic ranking pipelines.

Does it work with Zapier?

Yes. Use the ‘Webhooks by Zapier’ module to POST to the BoardQ endpoint. Or use Make / n8n — same idea, same JSON shape.

How do I embed a board on my site?

Every board has a public URL you drop into an iframe. Works on websites, Notion, Slack, OBS as a browser source, intranets — anywhere iframes render.

Start today

Five lines of curl. Live in production.

Free API access on the starter plan. Grab a key, read the docs, ship before lunch.

No setup fee · No contract · Cancel anytime