Create Appointment

POST {{baseUrl}}/api/v2/Appointment

Overview:

A targeted request for programmatically scheduling patient visits by flexibly specifying provider, location, services, verification requirements and visit timing attributes to drive automated workflows for appointment slot coordination behind patient scheduling interfaces.

Use Cases:

  • Self-Service Scheduling Portals: Enable patient self-scheduling

  • Referral Management Systems: Post follow-up specialist appointments

  • Queue Management Processes: Develop dynamic scheduling from queues

  • Patient Monitoring Systems: Schedule risk-based follow-ups

  • Workflow Integration Layers: Wrap posting for integration

Request Body

{"context"=>{"requestId"=>"<string>", "source"=>"<string>", "quorum"=>"<boolean>", "notify"=>"<boolean>"}, "data"=>{"resourceType"=>"<string>", "id"=>"<string>", "participant"=>[{"actor"=>{"reference"=>"<string>", "extension"=>[{"url"=>"<string>", "valueString"=>"<string>"}, {"url"=>"<string>", "valueString"=>"<string>"}]}}, {"actor"=>{"reference"=>"<string>", "extension"=>[{"url"=>"<string>", "valueString"=>"<string>"}, {"url"=>"<string>", "valueString"=>"<string>"}]}}], "minutesDuration"=>"<integer>", "start"=>"<dateTime>", "appointmentType"=>{"coding"=>[{"display"=>"<string>", "code"=>"<string>"}, {"display"=>"<string>", "code"=>"<string>"}], "text"=>"<string>"}, "status"=>"<string>", "extension"=>[{"url"=>"<string>", "valueString"=>"<string>", "valueCoding"=>{"system"=>"<string>", "code"=>"<string>", "display"=>"<string>"}, "valueAnnotation"=>[{"text"=>"<string>", "id"=>"<string>", "author"=>{"authorString"=>"<string>"}, "time"=>"<dateTime>"}, {"text"=>"<string>", "id"=>"<string>", "author"=>{"authorString"=>"<string>"}, "time"=>"<dateTime>"}]}, {"url"=>"<string>", "valueString"=>"<string>", "valueCoding"=>{"system"=>"<string>", "code"=>"<string>", "display"=>"<string>"}, "valueAnnotation"=>[{"text"=>"<string>", "id"=>"<string>", "author"=>{"authorString"=>"<string>"}, "time"=>"<dateTime>"}, {"text"=>"<string>", "id"=>"<string>", "author"=>{"authorString"=>"<string>"}, "time"=>"<dateTime>"}]}], "supportingInformation"=>[{"reference"=>"<string>"}, {"reference"=>"<string>"}]}}

HEADERS

KeyDatatypeRequiredDescription
x-source-idstring(Required) The source id provided for connecting to the data source
Content-Typestring
Authorizationstring

RESPONSES

status: OK

[{&quot;context&quot;:{&quot;requestId&quot;:&quot;\u003cstring\u003e&quot;,&quot;source&quot;:&quot;\u003cstring\u003e&quot;,&quot;quorum&quot;:&quot;\u003cboolean\u003e&quot;,&quot;notify&quot;:&quot;\u003cboolean\u003e&quot;},&quot;data&quot;:{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;}},{&quot;context&quot;:{&quot;requestId&quot;:&quot;\u003cstring\u003e&quot;,&quot;source&quot;:&quot;\u003cstring\u003e&quot;,&quot;quorum&quot;:&quot;\u003cboolean\u003e&quot;,&quot;notify&quot;:&quot;\u003cboolean\u003e&quot;},&quot;data&quot;:{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;}}]