Tross
Demo dataBook a demo
ELATION

Send message

Send chart messages to staff.

POSThttps://preview.ontross.com/api/integrations/elation/send-message
Request Fields
input.patient_id
string
required
Patient whose chart is read or written, from search-patients.
Example
"712044851039930"
input.body
string
required
Message text posted into the chart thread, 5000 characters max.
Example
"Please review and co-sign this month's CCM note for the care plan update."
input.to_user_ids
array
Elation user ids to route the message to, from list-physicians.
Example
["487489112780182"]
input.to_names
array
Recipient display names, each must resolve to exactly one user.
Example
["Rivera, Dana"]
input.send_date
string
Pd delivery date, stamped at midnight in the practice timezone.
Example
"2026-01-08"
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 send_date
Example
"America/Chicago"
Default
"America/Chicago"
auth_id
string
required
Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"
Output Fields
thread_id
string
Message thread Elation created for the chart message.
Example
"999000000000901"
patient_id
string
Patient whose chart is read or written, from search-patients.
Example
"999000000000101"
recipient_user_ids
array
Users the message went to, after names were resolved.
delivery_date
string
Date Elation will deliver the message, the Pd date.
Example
"01/08/2026 00:00:00 -0600"
is_on_hold
boolean
Whether the item is unsigned and still sitting on hold.
Example
true
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/elation/send-message \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"patient_id":"712044851039930","body":"Please review and co-sign this month'\''s CCM note for the care plan update.","to_user_ids":["487489112780182"],"to_names":["Rivera, Dana"],"send_date":"2026-01-08","urgent":false,"timezone":"America/Chicago"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patient_id": "712044851039930",
    "body": "Please review and co-sign this month's CCM note for the care plan update.",
    "to_user_ids": [
      "487489112780182"
    ],
    "to_names": [
      "Rivera, Dana"
    ],
    "send_date": "2026-01-08",
    "urgent": false,
    "timezone": "America/Chicago"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "thread_id": "999000000000901",
    "patient_id": "999000000000101",
    "recipient_user_ids": [
      "string"
    ],
    "delivery_date": "01/08/2026 00:00:00 -0600",
    "is_on_hold": true
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}