Skip to main content

Getting started

Nabla Connect is an integration protocol between Nabla and any EHR. It uses API calls between Nabla's server and your EHR's server so providers can start a Nabla encounter from the EHR, with patient context transferred in and the note exported back.

What it does​

  • Integrated encounter creation — a button in your EHR launches a Nabla encounter pre-linked to the current patient and encounter.
  • Contextual data sharing — Nabla receives patient context such as name, age, gender, and visit diagnoses.
  • Simplified note export — providers click Export Note and generated data flows back to the EHR.

Contact connect@nabla.com to create your organization.

User flow​

From the provider's perspective:

  1. The provider clicks the Nabla button on the EHR encounter screen.
  2. Nabla opens (iframe or browser tab) on an auto-created encounter enriched with EHR context.
  3. The provider records, generates, and reviews the note in Nabla.
  4. The provider clicks Export Note — note and structured data are sent back to the EHR.
Provider flow: open Nabla from the EHR, document the encounter, and export the note back

How it works​

Your backend calls Nabla to create or refresh an encounter (incoming APIs). Nabla calls your backend to export the generated note and other data (outgoing callbacks).

High-level sequence: create encounter from the EHR, then export the note back via callback

Integration checklist​

  • Set up an OAuth client and authenticate your backend.
  • Add a Nabla button on the EHR encounter screen that calls POST /encounters. See Launch encounters.
  • Optionally add a settings button that calls POST /settings/url without an encounter.
  • If embedding via iframe, add allow="microphone; clipboard-write" to the iframe (add loopback-network if you use Nabla Echo).
  • Expose a catch-all webhook endpoint and configure it in Nabla Connect Admin.
  • Verify HMAC signatures on incoming callbacks and handle NOTE_EXPORT and PATIENT_INSTRUCTIONS_EXPORT. See Receive callbacks.

How to get a test organization​

  1. Email connect@nabla.com and specify the email address that should have admin access.
  2. Once the test organization is ready, go to Nabla Connect Admin.
  3. Sign in with that admin email (a one-time code is sent to the mailbox).

Next steps​