Skip to content

Adapter · Coming soon

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.

The native n8n adapter has not shipped yet. Everything below works today through the REST API and webhooks— we'll update this page the moment the directory listing is live.

How to connect today#

  1. 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. 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. 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

Next#

Up next
Webhook signing
Read the guide