Elation Upload document

POSThttps://preview.ontross.com/api/integrations/elation/upload-document

Upload a file

Send multipart/form-data with auth_id, input serialized as JSON text, and exactly one original file in files. Let your HTTP client set the Content-Type boundary. In Try it, select a connection, fill in the input fields and choose the file.

The file must be non-empty and no larger than 50 MiB. Use the provider’s input fields below to select the patient and document destination.

auth_id

string

required

Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.

input.patient_id

string

required

Patient whose chart is read or written, from search-patients.

Example

"712044851039930"

input.title

string

required

e.g. "RPM Monthly Report - BP"

Example

"RPM Monthly Report - Blood Pressure"

input.reviewer_user_id

string

required

User queued to review the filed document.

Example

"999000000000201"

input.document_type

string

Type code ("MiscReport") or label ("Miscellaneous Report"); labels are resolved to codes

Example

"MiscReport"

Default

"MiscReport"

input.doc_tag_ids

array

Tag ids, used instead of resolving tag_names.

Example

["640118504325121"]

input.tag_names

array

Tag names to resolve to ids, e.g. ["RPM"]

Example

["RPM"]

input.reviewer_name

string

Reviewer resolved to a user id, if reviewer_user_id is omitted.

Example

"Dana Whitfield"

input.content_type

string

Media type Elation stored the attachment as.

Example

"application/pdf"

Default

"application/pdf"

input.urgent

boolean

Flags the message thread urgent in the recipient's inbox.

Example

false

Default

false

input.timezone

string

Practice timezone used to stamp document_date

Example

"America/Chicago"

Default

"America/Chicago"

files

file

required

Exactly one original document file; send its bytes, not a path or base64 string.

report_id

string

Document record Elation filed in the patient's chart.

Example

"999000000001101"

patient_id

string

Patient whose chart is read or written, from search-patients.

Example

"999000000000101"

title

string

Custom display heading returned with the filed document.

Example

"RPM Monthly Report - Blood Pressure"

report_type

string

Document type code Elation filed the upload under.

Example

"MiscReport"

reviewer_user_id

string

User queued to review the filed document.

Example

"999000000000201"

doc_tags

array

Tag labels on the filed document, not their ids.

document_date

string

Chart date Elation stamped on the note or document.

Example

"01/08/2026 14:25:30 -0600"

is_on_hold

boolean

Whether the item is unsigned and still sitting on hold.

Example

true

file

object

The stored attachment, null when Elation imported no file.

file.id

string

Stored attachment identifier returned with the filed report.

Example

"999000000001102"

file.original_filename

string

Filename the attachment arrived with.

Example

"rpm-blood-pressure-2026-01.pdf"

file.content_type

string

Media type Elation stored the attachment as.

Example

"application/pdf"

curl 'https://preview.ontross.com/api/integrations/elation/upload-document' \
  -H 'X-API-Key: YOUR_API_KEY' \
  --form-string 'auth_id=YOUR_AUTH_ID' \
  --form-string 'input={"patient_id":"712044851039930","title":"RPM Monthly Report - Blood Pressure","document_type":"MiscReport","doc_tag_ids":["640118504325121"],"tag_names":["RPM"],"reviewer_user_id":"999000000000201","reviewer_name":"Dana Whitfield","content_type":"application/pdf","urgent":false,"timezone":"America/Chicago"}' \
  -F 'files=@document.pdf;type=application/pdf'

input form field (JSON)

{
  "patient_id": "712044851039930",
  "title": "RPM Monthly Report - Blood Pressure",
  "document_type": "MiscReport",
  "doc_tag_ids": [
    "640118504325121"
  ],
  "tag_names": [
    "RPM"
  ],
  "reviewer_user_id": "999000000000201",
  "reviewer_name": "Dana Whitfield",
  "content_type": "application/pdf",
  "urgent": false,
  "timezone": "America/Chicago"
}

Response BODY

{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "report_id": "999000000001101",
    "patient_id": "999000000000101",
    "title": "RPM Monthly Report - Blood Pressure",
    "report_type": "MiscReport",
    "reviewer_user_id": "999000000000201",
    "doc_tags": [
      "string"
    ],
    "document_date": "01/08/2026 14:25:30 -0600",
    "is_on_hold": true,
    "file": {
      "id": "999000000001102",
      "original_filename": "rpm-blood-pressure-2026-01.pdf",
      "content_type": "application/pdf"
    }
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}