n8n
A SynthBoard community node for n8n is in development (it is not yet on the npm registry — don't install lookalike packages). n8n's built-in HTTP Request and Webhook nodes cover the full surface today, on both n8n Cloud and self-hosted.
How to connect today#
- 1
Create an API key
In SynthBoard, open /mcp/console → API Keys → Create, and store the sb_live_... token in an n8n credential (Header Auth: Authorization = Bearer <token>).
- 2
Call the REST API
Use an HTTP Request node against https://www.synthboard.ai/api/v1 — POST /sessions to start a board, GET /sessions/{id}?wait_ms=60000 to long-poll for the memo, POST /sessions/{id}/messages for Consult turns.
# HTTP Request node POST https://www.synthboard.ai/api/v1/sessions Header: Authorization: Bearer sb_live_... Body: {"question": "...", "session_type": "boardroom"} - 3
Handle webhook events
Add a Webhook node, copy its production URL, and register it: POST /api/v1/webhooks with the events you care about (session.complete, session.failed, outcomes.ready). Verify the X-SynthBoard-Signature header in a Code node.
Planned adapter surface#
What the native adapter will expose. Every operation already exists as a REST endpoint or webhook event you can use now.
Actions
- Plan / Start / Reconvene / Cancel Session
- Get / List / Export / Update / Archive / Delete Session
- Send Consult Message
- Generate Outcomes
- Synth Chat
- Search Catalog
- Create / List / Revoke Share
Triggers
- Session Complete
- Session Failed
- Outcomes Ready
Notes#
- The action list above is the planned node surface — every operation already exists as a REST endpoint you can call today