Skip to main content
POST
Create a patient chart note

Request Parameters

  • note (string, required): Chart note body content
  • subject (string, required): Chart note title
  • patient_mrn (string, required): Medical Record Number (MRN) of the patient
  • location_id (string, required for ModMed Gastro): EMR location ID. Must match a location returned by GET /v1/locations for the account. Not used by eClinicalWorks.
  • tags (array of strings, required for eClinicalWorks): One or more note category names, matched against the practice’s configured note categories. An unknown category fails the note.

Example Request

Example Response

The response includes:
  • patient_note_id: Unique identifier for the created patient note record
  • job_id: Job execution identifier for tracking the async operation

Error Responses

Missing Required Field

Invalid Location

Webhook Notifications

When the patient note processing is complete, we will send a webhook to your registered endpoint.

Success

Failure

Authorizations

client_id
string
header
required
client_secret
string
header
required
access_token
string
header
required

Body

application/json
note
string
required

Chart note body text.

Example:

"Patient called to report improved symptoms after starting the new medication."

patient_mrn
string
required

Medical Record Number of the patient the note is for.

Example:

"12345"

subject
string
required

Note subject / title.

Example:

"Follow-up call"

location_id
string

EMR location ID the note belongs to. Validated against the account’s locations.

Example:

"location-1"

tags
string[]

One or more note category names (eClinicalWorks "Additional Notes" tags). Matched case-insensitively against the practice’s configured categories; an unmatched category fails the note.

Example:
callback_urls
string[]

URLs to receive the completion webhook for this note, in addition to the account webhook.

Example:

Response

Patient note queued for creation

success
boolean
required
message
string
required
patient_note_id
string
required
job_id
required