Skip to main content

Changelog

All notable changes to Nabla Connect are listed here.

2026-11-17​

Added​

  • Embed SDK: new documentation for @nabla/connect-sdk, the browser SDK that follows and drives an encounter from the page that embeds the iframe. SDK releases are listed in the SDK changelog, not here.
  • POST /oauth/token — optional organization_uuid request field: the organization the access token is for. If present, it must be your OAuth Client's organization, otherwise the request is rejected with a 401. See Authentication.
  • POST /encounters — optional encounter_type: IN_PERSON or REMOTE. It sets the type of a new encounter. It is ignored on an existing encounter, so a type the provider changed in Nabla is kept.
  • New Instance API, served at https://<region>.api.nabla.com/v1/connect/instance, for the operations that act on your Nabla Connect instance as a whole rather than on one of its organizations. Its POST /oauth/token issues instance access tokens, which only authenticate Instance API calls. See Authentication.
  • Instance API: POST /organizations/lookup-by-idp-groups — find the organizations linked to your instance from the identity provider groups of a user, as configured for SAML SSO. Use it to know which organization to provision a user in.

Changed​

  • POST /oauth/token — no token is issued for a disabled organization anymore (ORGANIZATION_DISABLED), where the token used to be refused only when used. This change also applies to all prior versions.
  • POST /encounters/url and POST /settings/url — a deactivated provider is now rejected with a 401 (USER_DEACTIVATED), where the returned URL used to fail only once opened. Reactivate the provider first with POST …/activate. This change also applies to all prior versions.

2026-10-21​

Added​

  • POST /encounters — optional encounter_title: the title displayed for the encounter. Sending it replaces the encounter's current title; omit it to leave the title unchanged. It is not used for note generation.

Changed​

  • POST /users — speech_locale now accepts DUTCH_NL and DUTCH_BE. This change also applies to all prior versions.

2026-09-15​

Added​

  • POST /settings/url — generate a one-time-login URL that opens the provider's settings without an encounter.
  • POST /encounters — optional external_metadata object: 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 — optional template_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 the encounterProfileUuid query parameter from the URL. Omit to leave the encounter's current template unchanged.

Changed​

  • POST /users — specialty.kind now accepts URGENT_CARE. This change also applies to all prior versions.
  • POST /encounters — unstructured_context now accepts up to 10,000 characters (was 700). Generating the encounter note will take longer if you pass a long unstructured_context.

2026-08-25​

Added​

  • Note export callback — A&P 2.0: every note section now carries a structured_content object alongside the flattened content, discriminated by type. 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 inline icd10_codes (system, code, display, is_hcc, is_mcc) and snomed_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 content field is superseded by structured_content. It keeps being sent, but you should replace your usage of it.

2026-07-01​

Added​

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 by external_provider_id (and provider_email); optional settings for specialty and dictation locales. Returns 409 if the same ids point at two different existing users.
  • POST /encounters and POST /encounters/url — plural paths as the documented primary routes; POST /encounter and POST /encounter/url are now deprecated but stay available as aliases to preserve backward compatibility
  • Note export callback — optional visit_diagnoses can 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_data removed; use structured_context with patient_demographics (name, birth_date as YYYY-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 — optional unstructured_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.items alongside note).

Fixed​

  • Clarified that recreating an encounter with the same external_encounter_id after delete creates a new encounter without restoring the previous transcript or note.