Write To EHR

1upHealth makes writing back to multiple EHRs easy with a single end point.

Use 1upHealth FHIR API's to write to the EHR - just add an extension!

EHR Write Back Options:


SMART Health App

Directly to the EHR

Standalone App (not recommended)


Application that launches within the EHR and uses the providerโ€™s login & context

Data is written directly into the EHR via HL7 or EHR APIs

Separate application that is externally accessible via the web


  • Control the full UI/UX

  • Any data is supported - No extra login

  • Embedded within the EHR

  • Data shows up in the EHR

  • The provider has consistent data everywhere they navigate, CDS Hook support

  • No dependence on IT to approve or launch the app

  • Supports any data, full UX/UI control


  • Data may not show up within other screens in the EHR

  • Only supported on limited set of EHRs

  • Cannot control the UX/UI

  • Limited to data supported by the EHR

  • May require extra political hurdles

  • Requires extra login - Data does not show up within the EHR

  • Not easily discoverable

To get started

  1. Add a standard FHIR extension attribute to the FHIR resource

  2. The valueString is the 1upHealth id for the health system which you can get via our Connect API

  3. The url must always be https://1up.health/dev/concept/doc/1uphealth-system-write-identifier for us to write data back

"extension": [
"url": "https://1up.health/dev/concept/doc/1uphealth-system-write-identifier",
"valueString": "1234"

Services under the hood at 1up identify the health system's EHR and invoke the service specific transformation for that EHR and health system to write data back. Behind the scenes, we ensure that your application has the proper BAA relationship with the health system before any data is written back (and read for the matter). Below, is a full curl command to post a DocumentReference resource (STU3 version) to 1upHealth.

curl -XPOST 'https://api.1up.health/stu3/DocumentReference' \
-H 'Authorization: Bearer oneup_access_token' \
-H 'Content-Type: application/json' \
-d '{... json fhir resource object}'

An example format for the JSON FHIR resource would look like this. Note: the addition of the extension attribute.

"resourceType": "DocumentReference",
"extension": [
"url": "https://1up.health/dev/concept/doc/1uphealth-system-write-identifier",
"valueString": "1234"
"subject": {
"reference": "Patient/4gsdbvjhv"
"content": [
"attachment": {
"contentType": "application/html",
"url": "https://api.1up.health/stu3/Binary/ed16c91be4d2"
"format": {
"display": "History and Physical Specification"
"id": "12345",
"indexed": "2018-02-20T03:58:05.410Z",
"status": "current",


Reach out to our engineering team at: [email protected]โ€‹