Create Incoming Referral
Perform Create Incoming Referral through eClinicalWorks.
ecw_create_incoming_referralwriteeclinicalworks
Inputs
- Patient Id
patient_idtextrequiredRequired text value.
- Auth Number
auth_numbertextrequiredRequired text value.
- Visit Date
visit_datedaterequiredRequired date in YYYY-MM-DD format.
- Auth Start Date
auth_start_datedaterequiredRequired date in YYYY-MM-DD format.
- Auth End Date
auth_end_datedaterequiredRequired date in YYYY-MM-DD format.
- Reason
reasontextrequiredRequired text value.
- Sibling Visit Types
sibling_visit_typesjsonOptional JSON value.
- Referring Provider Last Name
referring_provider_last_nametextrequiredRequired text value.
- Resolved Provider Last Name
resolved_provider_last_nametextOptional text value.
- Encounter Id
encounter_idtextOptional text value.
- Encounter Ids
encounter_idsjsonOptional JSON value.
- Visits Allowed
visits_allowednumberOptional numeric value.
Default:
1 - Match Visit Date
match_visit_datebooleanOptional true-or-false value.
Default:
false - Link Notes
link_notestextareaOptional text value.
Outputs
successSuccessreferral_idReferral Idpatient_idPatient Idauth_numberAuth NumbererrorError
Output schema completeness: best_effort_declared
Safety
- External effect
- write
- Confirmation recommended
- No
- Retry safe
- No
- Dry run supported
- No
Schemas
These schemas are first-pass authoring guidance. Runtime validation remains authoritative.
Input schema
{
"type": "object",
"required": [
"patient_id",
"auth_number",
"visit_date",
"auth_start_date",
"auth_end_date",
"reason",
"referring_provider_last_name"
],
"properties": {
"reason": {
"type": "string",
"description": "Required text value.",
"x-workflow-field-type": "text"
},
"link_notes": {
"type": "string",
"description": "Optional text value.",
"x-workflow-field-type": "textarea"
},
"patient_id": {
"type": "string",
"description": "Required text value.",
"x-workflow-field-type": "text"
},
"visit_date": {
"type": "string",
"format": "date",
"description": "Required date in YYYY-MM-DD format.",
"x-workflow-field-type": "date"
},
"auth_number": {
"type": "string",
"description": "Required text value.",
"x-workflow-field-type": "text"
},
"encounter_id": {
"type": "string",
"description": "Optional text value.",
"x-workflow-field-type": "text"
},
"auth_end_date": {
"type": "string",
"format": "date",
"description": "Required date in YYYY-MM-DD format.",
"x-workflow-field-type": "date"
},
"encounter_ids": {
"description": "Optional JSON value.",
"x-workflow-field-type": "json"
},
"visits_allowed": {
"type": "number",
"default": 1,
"description": "Optional numeric value.",
"x-workflow-field-type": "number"
},
"auth_start_date": {
"type": "string",
"format": "date",
"description": "Required date in YYYY-MM-DD format.",
"x-workflow-field-type": "date"
},
"match_visit_date": {
"type": "boolean",
"default": false,
"description": "Optional true-or-false value.",
"x-workflow-field-type": "boolean"
},
"sibling_visit_types": {
"description": "Optional JSON value.",
"x-workflow-field-type": "json"
},
"resolved_provider_last_name": {
"type": "string",
"description": "Optional text value.",
"x-workflow-field-type": "text"
},
"referring_provider_last_name": {
"type": "string",
"description": "Required text value.",
"x-workflow-field-type": "text"
}
},
"additionalProperties": false
}Output schema
{
"type": "object",
"properties": {
"error": {},
"success": {},
"patient_id": {},
"auth_number": {},
"referral_id": {}
},
"additionalProperties": true
}