Overview

Introduction

Flow overview

Requirements

Versionning

Authentication

Server authentication

Incoming APIs

Overview

Provision user

Create encounter

Refresh encounter URL

Outgoing APIs

Overview

Callback authentication (HMAC)

Response protocol

Callback types

Reference

Changelog

Nabla Connect is an integration protocol between Nabla and any EHR, leveraging API calls between Nabla's server and your EHR's server. It enables healthcare providers to seamlessly initiate Nabla encounters directly from the EHR, with automatic context transfer and note export back to the EHR.

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: name, age, gender, visit diagnoses, and more.
• Simplified Note Export — Providers click Export Note and all generated data flows back to the EHR — no copy-pasting.

📧 Contact [email protected] to create your organisation

How it works

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

Integration checklist

• [ ] Set up an OAuth client and implement server authentication
• [ ] Add a Nabla button on the EHR encounter screen calling POST /encounter
• [ ] If embedding via iframe, add allow="microphone;" to the iframe
• [ ] Expose a catch-all webhook endpoint and configure it in the Nabla Connect Admin
• [ ] Implement HMAC signature verification on incoming callbacks
• [ ] Handle NOTE_EXPORT and PATIENT_INSTRUCTIONS_EXPORT callback types

Quick links