Tross
ATHENA

Send chart message

Send a staff message about a patient.

POSThttps://api.ontross.com/api/integrations/athena/send-chart-message
Request Fields
input.org_id
integer
required
Athena practice ID.
Example
32817
input.department_id
integer
required
Chart department ID.
Example
1
input.patient_id
integer
required
Practice patient ID the message is about.
Example
1133
input.recipient_username
string
required
athenaNet username of the staff recipient.
Example
"avermaa"
input.subject
string
required
Message subject (Athena caps it at 80 characters).
Example
"Lab follow-up"
input.message
string
required
Message body (Athena caps it at 2000 characters).
Example
"Please call the patient about the pending lab order."
input.priority
string
Message priority flag.
Example
"NORMAL"
Default
"NORMAL"
Accepted values
NORMALHIGHLOW
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
outcome
string
'sent' when the message was found in the patient's message list after posting; 'unconfirmed' when the post was accepted but the read-back did not show it.
Example
"sent"
message_id
string
Athena message ID from the read-back.
Example
"12128"
patient_id
string
Practice patient ID the message is about.
Example
"1133"
recipient_username
string
Recipient the message was addressed to.
Example
"avermaa"
subject
string
Subject as sent.
Example
"Lab follow-up"
priority
string
Priority as sent.
Example
"NORMAL"
sent_at
string
Timestamp Athena shows for the message.
Example
"10/29/26 06:01 AM"
Code
curl curl %s %s POST \
  --url https://api.ontross.com/api/integrations/athena/send-chart-message \
  %s %s 'X-API-Key: REPLACE_KEY_VALUE' \
  %s %s 'content-type: application/json' \
  %s %s '{"input":{"department_id":1,"message":"Please call the patient about the pending lab order.","org_id":32817,"patient_id":1133,"priority":"NORMAL","recipient_username":"avermaa","subject":"Lab follow-up"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "department_id": 1,
    "message": "Please call the patient about the pending lab order.",
    "org_id": 32817,
    "patient_id": 1133,
    "priority": "NORMAL",
    "recipient_username": "avermaa",
    "subject": "Lab follow-up"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "outcome": "sent",
    "message_id": "12128",
    "patient_id": "1133",
    "recipient_username": "avermaa",
    "subject": "Lab follow-up",
    "priority": "NORMAL",
    "sent_at": "10/29/26 06:01 AM"
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}