Official SDKs

Install a package for your stack. The SDK wraps the sandbox and webhook surfaces of the control plane today — catalog, domains, synthetic resources, scenario runner, HL7 inject, webhook delivery list/replay, and HMAC verification. The agent connection surface (/v1/connections, hash-chained audit) is plain HTTP today — agents use the API, MCP, or the CLI. Full reference lives in the dashboard SDK guide (opens in new tab).

Node.js

npm install @hebrah/sdk

import { HebrahClient } from '@hebrah/sdk'

const client = new HebrahClient({
  apiKey: process.env.HEBRAH_API_KEY!,
})

const patient = await client.patients.get('pat_00000000_01')
const catalog = await client.sandbox.catalog()
const domains = await client.sandbox.listDomains()

// Run a multi-step scenario
await client.sandbox.runScenario('prior_auth_happy_path', {
  patientId: 'pat_00000000_01',
})

// HL7 inject
await client.sandbox.injectHl7({
  templateId: 'ref_i12_referral',
  patientId: 'pat_00000000_01',
})

// Webhook delivery ops
const deliveries = await client.webhooks.listDeliveries()
await client.webhooks.replayDelivery(deliveries.items[0].id)

Python

pip install hebrah

from hebrah import HebrahClient

with HebrahClient(api_key="hb_test_your_key") as client:
    patient = client.patients.get("pat_00000000_01")
    catalog = client.sandbox.catalog()
    client.sandbox.run_scenario("prior_auth_happy_path", patient_id="pat_00000000_01")
    client.sandbox.inject_hl7(template_id="ref_i12_referral", patient_id="pat_00000000_01")
    deliveries = client.webhooks.list_deliveries()

Why use the SDK

• Sandbox domains: catalog, domain detail, synthetic resources, scenarios
• HL7 inject: template catalog and inject without hand-rolling fetch
• Webhook ops: list deliveries, replay stored envelopes, configure reliability profiles
• Webhook verify: verifyWebhookSignature / verify_webhook_signature with constant-time compare

Packages

• npm: @hebrah/sdk v0.5
• PyPI: hebrah