Skip to main content
POST
Create a recall
Recalls are created asynchronously: a valid request returns immediately, and a recall.created or recall.failed webhook is sent when processing completes. Creating recalls is only supported for ModMed EMA.

Authorizations

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

Body

application/json
patient_mrn
string
required

MRN of the patient the recall is for.

Example:

"12345"

recall_type
string
required

Exact recall type name as configured in the EMR.

Example:

"Inbound Referral 1 Week"

due_date
string
required

Target due date (YYYY-MM-DD).

Example:

"2026-09-01"

provider_ehr_id
string

EMR provider id for the recall. Supply this or provider_name (id preferred).

provider_name
string

Provider name as synced. Used only when provider_ehr_id is absent.

reason
string

Free-text reason for the recall.

appt_notes
string

Initial note on the recall.

callback_urls
string[]

URLs to receive the completion webhook for this create.

Response

Recall create queued for processing

success
boolean
required
message
string
required
recall_id
string
required
job_id
integer
required