Authentication
Incoming APIs
Outgoing APIs
Callback authentication (HMAC)
Reference
When backwards-incompatible changes are made to the API, a new, dated version is released. The latest version is 2026-03-23.
See Versioning for how to target a specific version in requests.
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 deprecated aliases but remain supported with the same behavior.visit_diagnoses with ICD-10 fields (code, display) and risk flags (is_hcc, is_mcc) are now returned when available.POST /encounter, replaced encounter_data body field with structured_contextPOST /encounter/url — generate a new URL for an existing encounterunstructured_context field added to POST /encounter bodyNOTE_EXPORT callback)POST /encounter with the same external_encounter_id now creates a new encounter without recovering the original transcript and note