Changelog
All notable changes to Nabla Connect are listed here.
2026-09-15
Added
POST /settings/url— generate a one-time-login URL that opens the provider's settings without an encounter.POST /encounters— optionalexternal_metadataobject: a flat string map from your EHR (for example a stay identifier). Nabla stores it encrypted and echoes it unchanged on note and patient-instructions export callbacks. It is not used for note generation. Omit the field to leave existing metadata unchanged; send{}to clear it.POST /encounters— optionaltemplate_id: preselects the encounter's note template. On the Templates tab of Nabla Admin (contact Nabla to enable template admin for your organization), select the template and use Copy template ID under Title, or copy theencounterProfileUuidquery parameter from the URL. Omit to leave the encounter's current template unchanged.
Changed
POST /encounters—unstructured_contextnow accepts up to 10,000 characters (was 700). Generating the encounter note will take longer if you pass a longunstructured_context.
2026-08-25
Added
- Note export callback — A&P 2.0: every note section now carries a
structured_contentobject alongside the flattenedcontent, discriminated bytype. Sections are either{ type: "TEXT", text }or{ type: "SUBSECTIONS", subsections }notably for the "Assessment & Plan" section. Each subsection is a per-problem entry (title,text, in note order) with inlineicd10_codes(system,code,display,is_hcc,is_mcc) andsnomed_codes(system,code,display). The code lists are empty when codes are not available at export time (e.g. code extraction disabled, or a manual export before extraction completed). See the callback reference.
Changed
- Auto-export now waits for A&P code extraction (in addition to note generation) for organizations with ICD-10 in Assessment & Plan enabled, so coded subsections are always present in the callback.
Deprecated
- Note export callback — the section-level
contentfield is superseded bystructured_content. It keeps being sent, but you should replace your usage of it.
2026-07-01
Added
POST /users/by_external_id/{external_provider_id}/activate,POST …/deactivate, andDELETE /users/by_external_id/{external_provider_id}.
2026-04-24
Added
structured_context.visit_diagnoses(optional) on encounter create/update and URL endpoints: list of{ system, code, display }codings. Only the ICD-10-CM system URI is accepted for persistence.
Changed
- Note generation that uses encounter visit diagnoses reads the list persisted from Connect structured context when available.
2026-03-23
Added
POST /users— upsert a provider user byexternal_provider_id(andprovider_email); optional settings for specialty and dictation locales. Returns409if the same ids point at two different existing users.POST /encountersandPOST /encounters/url— plural paths as the documented primary routes;POST /encounterandPOST /encounter/urlare now deprecated but stay available as aliases to preserve backward compatibility- Note export callback — optional
visit_diagnosescan be included in the payload with ICD-10 fields (code,display) and risk flags (is_hcc,is_mcc) when available.
Changed
- Copilot admin: clearer validation on the Nabla Connect OAuth client connection form.
2026-02-13
Changed
- Breaking:
POST /encounter—encounter_dataremoved; usestructured_contextwithpatient_demographics(name,birth_dateasYYYY-MM-DD,gender,pronouns). - Embedded webapp: “New encounter” and encounter history are hidden.
Added
POST /encounter/url— issue a URL for an existing encounter (external_encounter_id,external_provider_id).POST /encounter— optionalunstructured_context(free text for note context, max 700 characters).- Note export callback — encounter transcript can be included in the payload when the option is enabled in Admin (
transcript.itemsalongsidenote).
Fixed
- Clarified that recreating an encounter with the same
external_encounter_idafter delete creates a new encounter without restoring the previous transcript or note.