Run a boardroom
from any HTTP client.
Start sessions, capture decisions, ship outcomes — straight from your CRM, your CI, your Zap, your Slack bot. The same engine that powers SynthBoard.ai, with one secure key.
Native integrations on the platforms your team already uses
What you can build
A boardroom inside every workflow.
The API is the SynthBoard engine, exposed. Wire it into the tools your team already runs and let real decisions show up where the work happens.
Trigger a boardroom from your CRM
When a high-value deal stalls in HubSpot or Salesforce, fire a Zapier workflow that runs a Pre-Mortem session and posts the outcomes back as a deal note.
Auto-decide on Slack threads
Watch a Slack channel for messages tagged #decision. Run a Stress Test session, then post the synthesis back as a thread reply your team can act on.
Pre-mortem before a release
Hook the API into your CI. Before a major merge, run an Arena session to surface risks your reviewers missed — and gate the release on the score.
Custom GPTs and Claude projects
Wrap a few endpoints into a custom GPT or Claude project. Your users get an AI assistant that can run a real boardroom on demand.
Built for production
Everything you need, nothing you don't.
One engine, 27 endpoints
Every endpoint runs the same execution layer as the web app and the MCP server. Identical sessions, identical credits, identical synthesis — no drift between transports.
Secure auth that just works
Use API keys for your own scripts, or let third-party tools like Zapier and ChatGPT auth in via OAuth. Scoped, IP-allowlisted, daily-capped — your call.
Real-time webhooks
Subscribe to session.complete, outcomes.ready, and more. Verified signatures, automatic retries, no missed events.
Enterprise-grade
Per-call audit logs, scoped access, encrypted at rest, and full data isolation. Built for teams that need answers without compromise.
Streaming + async
Long-running sessions dispatch async — poll for completion or subscribe to a webhook. p95 session runtime under 90 seconds.
Native adapters
Ship-ready integrations for Zapier, n8n, Make, Pipedream, Activepieces, and Arcade. Plus an OpenAPI spec any client can consume.
Quickstart
From zero to running session, in three calls.
1. Create an API key
Open the Control Center and generate a key with the scopes you need.
2. Plan a session
curl https://synthboard.ai/api/v1/sessions/plan \
-H "Authorization: Bearer sb_live_..." \
-H "Content-Type: application/json" \
-d '{
"question": "Should we launch a free tier?",
"mode": "stress_test",
"rounds": 3,
"synth_count": 6
}'3. Start the session
curl https://synthboard.ai/api/v1/sessions \
-H "Authorization: Bearer sb_live_..." \
-H "Content-Type: application/json" \
-d '{"plan_id": "plan_abc123"}'4. Wait for the result
curl "https://synthboard.ai/api/v1/sessions/{id}?wait_ms=60000" \
-H "Authorization: Bearer sb_live_..."Key endpoints
The shortlist.
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/sessions | Start a session |
| POST | /api/v1/sessions/plan | Propose a session setup without starting |
| GET | /api/v1/sessions | List your sessions |
| GET | /api/v1/sessions/{id} | Get session state (optional wait) |
| POST | /api/v1/sessions/{id}/continue | Trigger a follow-up round |
| POST | /api/v1/sessions/{id}/outcomes | Generate action plan / report / memo |
| POST | /api/v1/sessions/{id}/export | Export as markdown / json / text |
| POST | /api/v1/synths/chat | 1-on-1 chat with a specific synth |
| GET | /api/v1/catalog/search | Search synths, modes, templates, strategies |
| POST | /api/v1/webhooks | Register a webhook subscription |
| GET | /api/v1/health | Unauthenticated health probe |
Native adapters
Skip the code.
Install SynthBoard on the platform you already use — connect once, automate forever.
Public integration with OAuth, webhook triggers, 10+ actions
Verified community node — OAuth + Bearer, on n8n Cloud
Apps SDK modules for every session operation
Component package with actions and webhook sources
TypeScript piece — also exposed as an MCP tool
Remote MCP registration, verified-tier eligible
Webhooks, the way they should work.
Subscribe to real-time events. Every delivery is signed and retried up to five times. Wire session outcomes straight into Slack, your CRM, or your own event bus.
Webhook signing guide// Verify a SynthBoard webhook
import { createHmac, timingSafeEqual } from "node:crypto";
app.post("/webhooks/synthboard", (req, res) => {
const sig = req.header("X-SynthBoard-Signature").replace("sha256=", "");
const ts = req.header("X-SynthBoard-Timestamp");
const body = req.rawBody;
const expected = createHmac("sha256", SECRET)
.update(`${ts}.${body}`)
.digest("hex");
if (!timingSafeEqual(Buffer.from(sig), Buffer.from(expected)))
return res.status(401).end();
// Handle event
res.status(200).end();
});FAQ
Frequently asked.
What's the difference between the REST API and the MCP server?
Same engine, different transports. MCP is what Claude Desktop, Cursor, and ChatGPT speak natively. REST is what Zapier, n8n, Make, and any other HTTP client speaks. Both use the same auth and you can switch between them freely.
Do I need an API key or OAuth?
Either. For your own scripts, API keys are simplest — generate one in the Control Center. For third-party tools that act on behalf of your users (like Zapier), OAuth is the right path and the client auto-registers.
How do I pay for API calls?
Credits. 1 credit = $0.01 USD. Each session consumes credits based on the model assignment, synth count, and rounds. Pre-purchase credits — no subscription, no monthly minimum, free tier included.
What's the rate limit?
Per-endpoint and tier-adjusted, default 60 requests per minute. Rate-limit responses include a Retry-After header. The full matrix lives in the API reference.
How do webhooks work?
Register a subscription in the Control Center or via the API. We deliver signed events to your URL on session.complete, outcomes.ready, and more. Failed deliveries auto-retry 5 times over 5 hours, then pause the subscription.
Is the REST API stable?
Yes. /api/v1/* is versioned and breaking changes require a new version. Deprecations get 90-day notice via the Sunset header and email to API key owners.
Ship the boardroom.
Generate an API key, run a session, wire the outcome back into your product.